@geneverse/workctl 0.2.5

package/dist/packages/capabilities/jira/src/commands/audit-links/audit-links.command.js

@@ -0,0 +1,165 @@
+import { CommanderError } from "commander";
+import { resolveDateRange } from "../../domain/date-range.js";
+import { classifyGrid, } from "../../domain/timesheet-entry.js";
+import { JiraClientError } from "../../ports/jira.js";
+import { formatHours } from "../../presentation.js";
+import { createLinkAuditReport, formatLinkAudit, } from "./audit-links.service.js";
+import { CliInteractionError } from "../../cli/errors.js";
+const JIRA_KEY = /^[A-Z][A-Z0-9]*-\d+$/;
+function replaceJiraKey(classified, oldKey, newKey) {
+    return {
+        ...classified,
+        eligible: classified.eligible.map((entry) => entry.jiraKey === oldKey
+            ? {
+                ...entry,
+                jiraKey: newKey,
+                description: entry.description.replace(new RegExp(`(?<![A-Z0-9])${oldKey}(?![A-Z0-9])`, "g"), newKey),
+            }
+            : entry),
+    };
+}
+async function readLinkIssuesWithRepair(config, initial, dependencies, interaction, writeStatus) {
+    if (!dependencies.readJiraLinkIssue) {
+        throw new CliInteractionError("Jira link audit is unavailable.");
+    }
+    let classified = initial;
+    const excluded = [];
+    const issuesByKey = new Map();
+    const pending = [
+        ...new Set(classified.eligible.flatMap((entry) => entry.jiraKey ? [entry.jiraKey] : [])),
+    ];
+    while (pending.length > 0) {
+        const jiraKey = pending.shift();
+        if (issuesByKey.has(jiraKey))
+            continue;
+        const message = `Loading Jira issue links · ${jiraKey}`;
+        if (interaction)
+            interaction.startLoading(message);
+        else
+            writeStatus(`${message}\n`);
+        try {
+            issuesByKey.set(jiraKey, await dependencies.readJiraLinkIssue(config, jiraKey));
+            interaction?.stopLoading(`Loaded Jira issue links · ${jiraKey}`);
+        }
+        catch (error) {
+            interaction?.failLoading(`Could not load Jira issue links · ${jiraKey}`);
+            if (!(error instanceof JiraClientError) || error.status !== 404)
+                throw error;
+            if (!interaction) {
+                throw new CliInteractionError(`${error.message} Run this command in an interactive terminal to correct the Jira key, ` +
+                    "or fix the description in Kawari.");
+            }
+            const affected = classified.eligible.filter((entry) => entry.jiraKey === jiraKey);
+            const resolution = await interaction.resolveMissingJiraIssue({
+                jiraKey,
+                entries: affected.map(({ date, description, duration }) => ({
+                    date,
+                    description,
+                    duration,
+                })),
+            });
+            if (resolution.action === "cancel") {
+                throw new CommanderError(0, "auditLinks.cancelled", "Link audit cancelled.");
+            }
+            if (resolution.action === "exclude") {
+                excluded.push(...affected.map((entry) => ({
+                    ...entry,
+                    jiraKey,
+                    exclusionKind: "Missing Jira Issue",
+                    exclusionReason: "Excluded by user for this batch.",
+                })));
+                classified = {
+                    ...classified,
+                    eligible: classified.eligible.filter((entry) => entry.jiraKey !== jiraKey),
+                };
+                continue;
+            }
+            const replacement = resolution.jiraKey.trim().toUpperCase();
+            if (!JIRA_KEY.test(replacement)) {
+                throw new CliInteractionError(`Invalid replacement Jira issue key "${replacement}".`);
+            }
+            classified = replaceJiraKey(classified, jiraKey, replacement);
+            pending.unshift(replacement);
+        }
+    }
+    const keys = new Set(classified.eligible.flatMap((entry) => entry.jiraKey ? [entry.jiraKey] : []));
+    return {
+        classified,
+        excluded,
+        issues: [...keys].map((key) => issuesByKey.get(key)),
+    };
+}
+export function registerAuditLinksCommand({ program, io, dependencies, effectiveConfig }) {
+    const interaction = io.interaction ?? io.batchInteraction;
+    const info = (message) => {
+        if (interaction)
+            interaction.info(message.trimEnd());
+        else
+            io.stdout(message);
+    };
+    program
+        .command("audit-links")
+        .description("audit Jira link statuses for issues found in Kawari")
+        .option("--from <date>", "start date in YYYY-MM-DD format")
+        .option("--to <date>", "end date in YYYY-MM-DD format")
+        .option("--export <format>", "write a link audit export (csv or json)")
+        .action(async (options) => {
+        if (options.export !== undefined && options.export !== "csv" && options.export !== "json") {
+            throw new CommanderError(2, "auditLinks.invalidExportFormat", "--export must be either csv or json.");
+        }
+        const config = effectiveConfig().config;
+        if (!config.linkAudit) {
+            throw new CommanderError(2, "auditLinks.notConfigured", "Link audit is not configured. Run `workctl jira configure` to add Jira projects and done statuses.");
+        }
+        let range = resolveDateRange(options.from, options.to);
+        if (options.from === undefined && options.to === undefined && interaction) {
+            const selectedRange = await interaction.requestDateRange("audit-links", range);
+            if (!selectedRange)
+                return;
+            range = selectedRange;
+        }
+        interaction?.begin("audit-links", range.from, range.to);
+        interaction?.startLoading("Opening Kawari timesheet");
+        let inspection;
+        try {
+            inspection = await dependencies.inspect(config.timesheetUrl, range.from.slice(0, 7));
+        }
+        catch (error) {
+            interaction?.failLoading("Failed to load Kawari timesheet");
+            throw error;
+        }
+        const classified = classifyGrid(inspection.grid, range);
+        const batchEntries = [...classified.eligible, ...classified.unmapped];
+        const entryCount = batchEntries.length +
+            classified.invalid.length +
+            classified.zeroDuration.length;
+        const batchHours = batchEntries.reduce((total, entry) => total + entry.duration, 0);
+        interaction?.stopLoading(`Loaded ${entryCount} ${entryCount === 1 ? "entry" : "entries"} · ${formatHours(batchHours)}`);
+        if (classified.invalid.length > 0) {
+            throw new CommanderError(1, "auditLinks.blocked", "Invalid Timesheet Entries block the link audit.");
+        }
+        const loaded = await readLinkIssuesWithRepair(config, classified, dependencies, interaction, io.stdout);
+        const report = createLinkAuditReport(loaded.issues, config.linkAudit);
+        const formatted = formatLinkAudit(report, {
+            color: io.color === true,
+            ...(io.terminalWidth
+                ? {
+                    terminalWidth: interaction
+                        ? Math.max(20, io.terminalWidth - 6)
+                        : io.terminalWidth,
+                }
+                : {}),
+        });
+        if (interaction)
+            interaction.note("Link status audit", formatted.trimEnd());
+        else
+            io.stdout(formatted);
+        if (options.export) {
+            const format = options.export;
+            const destination = await dependencies.writeLinkAuditExport(range.from, range.to, format, report.records);
+            info(`Audit export: ${destination}\n`);
+        }
+        interaction?.complete("Link status audit complete. No Jira issues were changed.");
+    });
+}
+//# sourceMappingURL=audit-links.command.js.map

package/dist/packages/capabilities/jira/src/commands/audit-links/audit-links.command.js.map

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

package/dist/packages/capabilities/jira/src/commands/audit-links/audit-links.service.d.ts

@@ -0,0 +1,30 @@
+import type { AuditFormat } from "../sync/audit-export.service.js";
+import type { LinkAuditConfig } from "../../config.js";
+import type { JiraLinkIssueSnapshot } from "../../ports/jira.js";
+import { type PresentationOptions } from "../../presentation.js";
+export type LinkAuditOutcome = "Mismatch" | "Aligned" | "No Links" | "Not Configured" | "Out of Scope";
+export interface LinkAuditRecord {
+    outcome: LinkAuditOutcome;
+    issueKey: string;
+    issueSummary: string;
+    issueStatus: string;
+    linkType: string;
+    relationship: string;
+    linkedIssueKey: string;
+    linkedIssueSummary: string;
+    linkedIssueStatus: string;
+}
+export interface LinkAuditReport {
+    records: LinkAuditRecord[];
+    sourceCount: number;
+    completedSourceCount: number;
+    skippedSourceCount: number;
+    skippedProjects: string[];
+}
+export declare class LinkAuditError extends Error {
+    constructor(message: string);
+}
+export declare function createLinkAuditReport(sourceIssues: readonly JiraLinkIssueSnapshot[], config: LinkAuditConfig): LinkAuditReport;
+export declare function formatLinkAudit(report: LinkAuditReport, options?: PresentationOptions): string;
+export declare function serializeLinkAudit(records: readonly LinkAuditRecord[], format: AuditFormat): string;
+export declare function writeLinkAuditExport(directory: string, from: string, to: string, format: AuditFormat, records: readonly LinkAuditRecord[], now?: Date): Promise<string>;

package/dist/packages/capabilities/jira/src/commands/audit-links/audit-links.service.js

@@ -0,0 +1,174 @@
+import { mkdir, open } from "node:fs/promises";
+import path from "node:path";
+import { formatTable, paint, } from "../../presentation.js";
+export class LinkAuditError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "LinkAuditError";
+    }
+}
+function projectKey(issueKey) {
+    return issueKey.slice(0, issueKey.lastIndexOf("-")).toUpperCase();
+}
+function normalized(value) {
+    return value.trim().toLocaleLowerCase();
+}
+function projectDoneStatuses(config, issueKey) {
+    const project = projectKey(issueKey);
+    const configured = config.projects[project];
+    return configured ? new Set(configured.doneStatuses.map(normalized)) : undefined;
+}
+export function createLinkAuditReport(sourceIssues, config) {
+    const sortedSources = [...sourceIssues].sort((a, b) => a.key.localeCompare(b.key));
+    const scoped = sortedSources.filter((source) => projectDoneStatuses(config, source.key));
+    const skipped = sortedSources.filter((source) => !projectDoneStatuses(config, source.key));
+    const completed = scoped.filter((source) => projectDoneStatuses(config, source.key).has(normalized(source.status)));
+    const records = skipped.map((source) => ({
+        outcome: "Out of Scope",
+        issueKey: source.key,
+        issueSummary: source.summary,
+        issueStatus: source.status,
+        linkType: "",
+        relationship: "",
+        linkedIssueKey: "",
+        linkedIssueSummary: "",
+        linkedIssueStatus: "",
+    }));
+    const seenPairs = new Set();
+    for (const source of completed) {
+        if (source.links.length === 0) {
+            records.push({
+                outcome: "No Links",
+                issueKey: source.key,
+                issueSummary: source.summary,
+                issueStatus: source.status,
+                linkType: "",
+                relationship: "",
+                linkedIssueKey: "",
+                linkedIssueSummary: "",
+                linkedIssueStatus: "",
+            });
+            continue;
+        }
+        for (const link of source.links) {
+            const pair = [source.key, link.issue.key].sort().join("\0");
+            if (seenPairs.has(pair))
+                continue;
+            seenPairs.add(pair);
+            const targetStatuses = projectDoneStatuses(config, link.issue.key);
+            const aligned = targetStatuses?.has(normalized(link.issue.status));
+            records.push({
+                outcome: targetStatuses === undefined
+                    ? "Not Configured"
+                    : aligned ? "Aligned" : "Mismatch",
+                issueKey: source.key,
+                issueSummary: source.summary,
+                issueStatus: source.status,
+                linkType: link.type,
+                relationship: link.relationship,
+                linkedIssueKey: link.issue.key,
+                linkedIssueSummary: link.issue.summary,
+                linkedIssueStatus: link.issue.status,
+            });
+        }
+    }
+    const rank = {
+        Mismatch: 0,
+        Aligned: 1,
+        "No Links": 2,
+        "Not Configured": 3,
+        "Out of Scope": 4,
+    };
+    records.sort((a, b) => rank[a.outcome] - rank[b.outcome] ||
+        a.issueKey.localeCompare(b.issueKey) ||
+        a.linkedIssueKey.localeCompare(b.linkedIssueKey));
+    return {
+        records,
+        sourceCount: sortedSources.length,
+        completedSourceCount: completed.length,
+        skippedSourceCount: skipped.length,
+        skippedProjects: [...new Set(skipped.map((source) => projectKey(source.key)))].sort(),
+    };
+}
+export function formatLinkAudit(report, options = {}) {
+    const sections = [];
+    const presentation = {
+        Mismatch: { heading: "MISMATCHES", tone: "red" },
+        Aligned: { heading: "ALIGNED", tone: "green" },
+        "No Links": { heading: "NO LINKS", tone: "yellow" },
+        "Not Configured": { heading: "NOT CONFIGURED", tone: "yellow" },
+        "Out of Scope": { heading: "OUT OF SCOPE", tone: "gray" },
+    };
+    for (const outcome of ["Mismatch", "Aligned", "No Links", "Not Configured"]) {
+        const records = report.records.filter((record) => record.outcome === outcome);
+        if (records.length === 0)
+            continue;
+        const { heading, tone } = presentation[outcome];
+        sections.push(paint(`${heading} (${records.length})`, tone, options), "");
+        const table = outcome === "No Links"
+            ? formatTable(["ISSUE", "STATUS"], records.map((record) => [record.issueKey, record.issueStatus]), options)
+            : formatTable(["SOURCE", "STATUS", "LINK", "TARGET", "STATUS"], records.map((record) => [
+                record.issueKey,
+                record.issueStatus,
+                `${record.relationship} · ${record.linkType}`,
+                record.linkedIssueKey,
+                record.linkedIssueStatus,
+            ]), options);
+        sections.push(paint(table[0], "gray", options), ...table.slice(1), "");
+    }
+    const mismatches = report.records.filter((record) => record.outcome === "Mismatch").length;
+    const aligned = report.records.filter((record) => record.outcome === "Aligned").length;
+    const noLinks = report.records.filter((record) => record.outcome === "No Links").length;
+    const notConfigured = report.records.filter((record) => record.outcome === "Not Configured").length;
+    sections.push(paint("SUMMARY", "cyan", options), `Sources ${report.sourceCount} · Completed ${report.completedSourceCount} · ` +
+        `Mismatch ${mismatches} · Aligned ${aligned} · No links ${noLinks} · ` +
+        `Not configured ${notConfigured} · Skipped ${report.skippedSourceCount}` +
+        (report.skippedProjects.length > 0 ? ` (${report.skippedProjects.join(", ")})` : ""));
+    return `${sections.join("\n")}\n`;
+}
+function csvCell(value) {
+    return /[",\r\n]/.test(value) ? `"${value.replaceAll('"', '""')}"` : value;
+}
+export function serializeLinkAudit(records, format) {
+    if (format === "json")
+        return `${JSON.stringify(records, null, 2)}\n`;
+    const fields = [
+        "outcome",
+        "issueKey",
+        "issueSummary",
+        "issueStatus",
+        "linkType",
+        "relationship",
+        "linkedIssueKey",
+        "linkedIssueSummary",
+        "linkedIssueStatus",
+    ];
+    return `${[
+        fields.join(","),
+        ...records.map((record) => fields.map((field) => csvCell(record[field])).join(",")),
+    ].join("\n")}\n`;
+}
+export async function writeLinkAuditExport(directory, from, to, format, records, now = new Date()) {
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    const timestamp = now.toISOString().replaceAll(":", "").replaceAll(".", "-");
+    const base = `audit-links-${from}-${to}-${timestamp}`;
+    for (let suffix = 0;; suffix += 1) {
+        const filename = `${base}${suffix === 0 ? "" : `-${suffix}`}.${format}`;
+        const destination = path.join(directory, filename);
+        try {
+            const handle = await open(destination, "wx", 0o600);
+            try {
+                await handle.writeFile(serializeLinkAudit(records, format), "utf8");
+            }
+            finally {
+                await handle.close();
+            }
+            return destination;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+        }
+    }
+}
+//# sourceMappingURL=audit-links.service.js.map

package/dist/packages/capabilities/jira/src/commands/audit-links/audit-links.service.js.map

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

package/dist/packages/capabilities/jira/src/commands/command-context.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from "commander";
+import type { EffectiveConfig } from "../config.js";
+import type { CliDependencies, CliIO } from "../cli/contracts.js";
+export interface CommandContext {
+    program: Command;
+    io: CliIO;
+    dependencies: CliDependencies;
+    effectiveConfig(): EffectiveConfig;
+    output(message: string, title?: string): void;
+}

package/dist/packages/capabilities/jira/src/commands/command-context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-context.js.map

package/dist/packages/capabilities/jira/src/commands/command-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-context.js","sourceRoot":"","sources":["../../../../../../packages/capabilities/jira/src/commands/command-context.ts"],"names":[],"mappings":""}

package/dist/packages/capabilities/jira/src/commands/config-show/config-show.command.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../command-context.js";
+export declare function registerConfigShowCommand({ program, dependencies, effectiveConfig, output }: CommandContext): void;

package/dist/packages/capabilities/jira/src/commands/config-show/config-show.command.js

@@ -0,0 +1,26 @@
+import { CONFIG_FIELDS } from "../../config.js";
+export function registerConfigShowCommand({ program, dependencies, effectiveConfig, output }) {
+    const configCommand = program.command("config").description("inspect jira configuration");
+    configCommand
+        .command("show")
+        .description("show effective configuration with secrets redacted")
+        .action(() => {
+        const effective = effectiveConfig();
+        const configPath = dependencies.configPath;
+        const lines = [`Config path: ${configPath}`];
+        for (const field of CONFIG_FIELDS) {
+            const value = field === "jiraApiToken" ? "<redacted>" : effective.config[field];
+            lines.push(`${field}: ${value} (${effective.sources[field]})`);
+        }
+        if (effective.config.linkAudit) {
+            for (const [project, projectConfig] of Object.entries(effective.config.linkAudit.projects)) {
+                lines.push(`linkAudit.projects.${project}.doneStatuses: ${projectConfig.doneStatuses.join(", ")} (config)`);
+            }
+        }
+        else {
+            lines.push("linkAudit: <not configured>");
+        }
+        output(`${lines.join("\n")}\n`, "Configuration");
+    });
+}
+//# sourceMappingURL=config-show.command.js.map

package/dist/packages/capabilities/jira/src/commands/config-show/config-show.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-show.command.js","sourceRoot":"","sources":["../../../../../../../packages/capabilities/jira/src/commands/config-show/config-show.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,UAAU,yBAAyB,CACvC,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAkB;IAElE,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC;IAC1F,aAAa;SACV,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC;QAC3C,MAAM,KAAK,GAAG,CAAC,gBAAgB,UAAU,EAAE,CAAC,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChF,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,KAAK,KAAK,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC/B,KAAK,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CACnD,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CACpC,EAAE,CAAC;gBACF,KAAK,CAAC,IAAI,CACR,sBAAsB,OAAO,kBAC3B,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CACtC,WAAW,CACZ,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/packages/capabilities/jira/src/commands/configure/configure.command.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from "../command-context.js";
+export declare function registerConfigureCommand({ program, dependencies }: CommandContext): void;

package/dist/packages/capabilities/jira/src/commands/configure/configure.command.js

@@ -0,0 +1,26 @@
+import { CommanderError } from "commander";
+import { CliInteractionError } from "../../cli/errors.js";
+import { SetupCancelledError } from "./configure.service.js";
+export function registerConfigureCommand({ program, dependencies }) {
+    program
+        .command("configure")
+        .description("interactively configure jira for the current user")
+        .action(async () => {
+        if (!dependencies.setup) {
+            throw new CliInteractionError("workctl jira configure is unavailable.");
+        }
+        try {
+            await dependencies.setup(false);
+        }
+        catch (error) {
+            if (error instanceof SetupCancelledError) {
+                throw new CommanderError(130, "configure.cancelled", error.message);
+            }
+            if (error instanceof Error && error.message.includes("interactive terminal")) {
+                throw new CliInteractionError(error.message);
+            }
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=configure.command.js.map

package/dist/packages/capabilities/jira/src/commands/configure/configure.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.command.js","sourceRoot":"","sources":["../../../../../../../packages/capabilities/jira/src/commands/configure/configure.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,UAAU,wBAAwB,CAAC,EAAE,OAAO,EAAE,YAAY,EAAkB;IAChF,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,mDAAmD,CAAC;SAChE,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YACxB,MAAM,IAAI,mBAAmB,CAAC,wCAAwC,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;gBACzC,MAAM,IAAI,cAAc,CAAC,GAAG,EAAE,qBAAqB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;gBAC7E,MAAM,IAAI,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/C,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/packages/capabilities/jira/src/commands/configure/configure.service.d.ts

@@ -0,0 +1,42 @@
+import { type AppConfig } from "../../config.js";
+import type { JiraProject, JiraProjectStatus } from "../../ports/jira.js";
+export declare class SetupCancelledError extends Error {
+    constructor();
+}
+export interface SetupPrompts {
+    intro(title: string): void;
+    text(options: {
+        message: string;
+        initialValue?: string;
+        validate: (value: string | undefined) => string | undefined;
+    }): Promise<string>;
+    password(options: {
+        message: string;
+        validate: (value: string | undefined) => string | undefined;
+    }): Promise<string>;
+    confirm(options: {
+        message: string;
+        initialValue: boolean;
+    }): Promise<boolean>;
+    multiselect(options: {
+        message: string;
+        options: readonly {
+            value: string;
+            label: string;
+        }[];
+        initialValues?: readonly string[];
+        required?: boolean;
+    }): Promise<string[]>;
+    note(message: string, title: string): void;
+    outro(message: string): void;
+}
+export interface ConfigureDependencies {
+    createJiraClient(jiraBaseUrl: string, jiraEmail: string, jiraApiToken: string): {
+        listProjects(): Promise<JiraProject[]>;
+        listProjectStatuses(projectKey: string): Promise<JiraProjectStatus[]>;
+    };
+    writeConfig(configPath: string, config: AppConfig): Promise<void>;
+}
+export declare const clackSetupPrompts: SetupPrompts;
+export declare function hasValidStoredConfig(configPath: string): boolean;
+export declare function runSetup(configPath: string, interactive: boolean, dependencies: ConfigureDependencies, prompts?: SetupPrompts, mode?: "compact" | "full"): Promise<void>;