@avocadostudio-ai/orchestrator-core 0.1.0

package/dist/jira/jira-types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * JIRA integration types.
+ * Covers webhook payloads, REST API responses, and internal processing types.
+ */
+export type JiraUser = {
+    accountId?: string;
+    name?: string;
+    displayName: string;
+    emailAddress?: string;
+};
+export type JiraIssue = {
+    key: string;
+    id: string;
+    fields: {
+        summary: string;
+        description: unknown;
+        status: {
+            name: string;
+            id: string;
+        };
+        labels: string[];
+        attachment: JiraAttachment[];
+        reporter?: JiraUser;
+        assignee?: JiraUser | null;
+        creator?: JiraUser;
+        comment?: {
+            comments: JiraComment[];
+        };
+        /** Custom fields can carry siteId, slug, etc. */
+        [key: string]: unknown;
+    };
+};
+export type JiraComment = {
+    id: string;
+    author: JiraUser;
+    body: unknown;
+    created: string;
+    updated: string;
+};
+export type JiraAttachment = {
+    id: string;
+    filename: string;
+    mimeType: string;
+    size: number;
+    content: string;
+};
+export type JiraTransition = {
+    id: string;
+    name: string;
+    to: {
+        name: string;
+        id: string;
+    };
+};
+export type JiraWebhookPayload = {
+    webhookEvent: string;
+    issue_event_type_name?: string;
+    timestamp: number;
+    issue: JiraIssue;
+    comment?: JiraComment;
+    changelog?: {
+        items: Array<{
+            field: string;
+            fieldtype: string;
+            from: string | null;
+            fromString: string | null;
+            to: string | null;
+            toString: string | null;
+        }>;
+    };
+    user?: JiraUser;
+};
+export type JiraProcessingResult = {
+    issueKey: string;
+    status: "success" | "error";
+    summary: string;
+    changes: string[];
+    durationMs: number;
+    modelUsed?: string;
+    published?: boolean;
+    error?: string;
+};
+export type JiraProcessingEntry = {
+    issueKey: string;
+    state: "queued" | "processing" | "done" | "error";
+    queuedAt: number;
+    startedAt?: number;
+    completedAt?: number;
+    result?: JiraProcessingResult;
+};
+export type JiraConfig = {
+    baseUrl: string;
+    email: string;
+    apiToken: string;
+    webhookSecret?: string;
+    agentAccountId?: string;
+    /** Legacy alias for reviewStatus — kept so pre-3-stage configs keep working. */
+    triggerStatus: string;
+    /** Status where tickets wait for agent review / reporter approval before edits. */
+    reviewStatus: string;
+    /** Status the agent transitions tickets to when it starts applying edits. */
+    executeStatus: string;
+    /** Status the agent transitions tickets to once draft edits are ready for preview. */
+    previewStatus: string;
+    doneStatus: string;
+    failedStatus?: string;
+    siteId: string;
+    session: string;
+    /** Skip the preview stage: auto-publish after execute and close the ticket. */
+    autoPublish: boolean;
+    /** Max review rounds per ticket before the agent forces a proceed-or-stop. */
+    maxReviewPasses: number;
+    pollEnabled: boolean;
+    pollJql: string;
+    pollIntervalMs: number;
+};
+export declare function loadJiraConfig(): JiraConfig | null;

package/dist/jira/jira-types.js

@@ -0,0 +1,38 @@
+/**
+ * JIRA integration types.
+ * Covers webhook payloads, REST API responses, and internal processing types.
+ */
+export function loadJiraConfig() {
+    const baseUrl = process.env.JIRA_BASE_URL?.trim();
+    const apiToken = process.env.JIRA_API_TOKEN?.trim();
+    if (!baseUrl || !apiToken)
+        return null;
+    // Status names: prefer the new 3-stage config, fall back to legacy triggerStatus.
+    const reviewStatus = process.env.JIRA_REVIEW_STATUS?.trim()
+        || process.env.JIRA_TRIGGER_STATUS?.trim()
+        || "To Do";
+    const executeStatus = process.env.JIRA_EXECUTE_STATUS?.trim() || "In Progress";
+    const previewStatus = process.env.JIRA_PREVIEW_STATUS?.trim() || "In Review";
+    const doneStatus = process.env.JIRA_DONE_STATUS?.trim() || "Done";
+    return {
+        baseUrl: baseUrl.replace(/\/+$/, ""),
+        email: process.env.JIRA_USER_EMAIL?.trim() ?? "",
+        apiToken,
+        webhookSecret: process.env.JIRA_WEBHOOK_SECRET?.trim() || undefined,
+        agentAccountId: process.env.JIRA_AGENT_ACCOUNT_ID?.trim() || undefined,
+        triggerStatus: reviewStatus,
+        reviewStatus,
+        executeStatus,
+        previewStatus,
+        doneStatus,
+        failedStatus: process.env.JIRA_FAILED_STATUS?.trim() || undefined,
+        siteId: process.env.JIRA_SITE_ID?.trim() || "avocado-stories",
+        session: process.env.JIRA_SESSION?.trim() || "dev",
+        autoPublish: process.env.JIRA_AUTO_PUBLISH === "1",
+        maxReviewPasses: Number(process.env.JIRA_MAX_REVIEW_PASSES) || 3,
+        pollEnabled: process.env.JIRA_POLL_ENABLED === "1",
+        pollJql: process.env.JIRA_POLL_JQL?.trim()
+            || `status in ("${reviewStatus}", "${previewStatus}")`,
+        pollIntervalMs: Number(process.env.JIRA_POLL_INTERVAL_MS) || 60_000,
+    };
+}

package/dist/logger.d.ts

@@ -0,0 +1,12 @@
+export interface Logger {
+    info(obj: object, msg?: string): void;
+    info(msg: string): void;
+    warn(obj: object, msg?: string): void;
+    warn(msg: string): void;
+    error(obj: object, msg?: string): void;
+    error(msg: string): void;
+    debug(obj: object, msg?: string): void;
+    debug(msg: string): void;
+}
+/** Console-backed Logger. Useful as a default in createOrchestrator(). */
+export declare function consoleLogger(): Logger;

package/dist/logger.js

@@ -0,0 +1,28 @@
+/** Console-backed Logger. Useful as a default in createOrchestrator(). */
+export function consoleLogger() {
+    const fmt = (level, a, b) => {
+        if (typeof a === "string")
+            return `[${level}] ${a}`;
+        if (b !== undefined)
+            return [`[${level}] ${b}`, a];
+        return [`[${level}]`, a];
+    };
+    return {
+        info: (a, b) => {
+            const out = fmt("info", a, b);
+            Array.isArray(out) ? console.log(...out) : console.log(out);
+        },
+        warn: (a, b) => {
+            const out = fmt("warn", a, b);
+            Array.isArray(out) ? console.warn(...out) : console.warn(out);
+        },
+        error: (a, b) => {
+            const out = fmt("error", a, b);
+            Array.isArray(out) ? console.error(...out) : console.error(out);
+        },
+        debug: (a, b) => {
+            const out = fmt("debug", a, b);
+            Array.isArray(out) ? console.debug(...out) : console.debug(out);
+        },
+    };
+}

package/dist/migration/mcp-server-stdio.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env npx tsx
+/**
+ * Standalone MCP stdio server for site migration tools.
+ * Spawned by the Claude CLI via --mcp-config.
+ *
+ * Usage: MIGRATION_SESSION=dev npx tsx apps/orchestrator/src/migration/mcp-server-stdio.ts
+ */
+export {};