@tickernelz/paperclip-pro-shared 2026.925.0

package/dist/pipeline-health.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Setup-health warnings for pipelines.
+ *
+ * The goal is to warn — in plain, Zapier-level language with zero technical
+ * vocabulary — about any configuration that simply will not run, *before*
+ * someone discovers it mid-workflow. The copy here intentionally avoids words
+ * like "routine", "dispatch", or "JWT": a paused agent is "a paused teammate",
+ * a routine is "the instructions for this step", and so on.
+ *
+ * This module is a pure function so it can be unit-tested and shared between the
+ * server (which assembles the inputs from the database) and the UI.
+ */
+export type PipelineHealthWarningCode = "paused_agent" | "stage_no_automation" | "automation_no_instructions" | "automation_no_agent" | "automation_failed" | "review_no_approver" | "missing_pipeline_reference" | "missing_stage_reference" | "breakdown_target_missing" | "breakdown_no_wait" | "breakdown_target_not_entry_safe" | "breakdown_field_mismatch" | "unset_required_variable";
+export interface PipelineHealthWarning {
+    /** Machine-readable reason; UI keys icons/grouping off this. */
+    code: PipelineHealthWarningCode;
+    /** The stage the warning is anchored to. */
+    stageId: string;
+    stageKey: string;
+    stageName: string;
+    /** Plain-language, prosumer-safe message ready to render as-is. */
+    message: string;
+    /** Optional UI route for the next useful place to inspect or fix the warning. */
+    href?: string;
+    hrefLabel?: string;
+}
+export interface PipelineHealthReport {
+    pipelineId: string;
+    warnings: PipelineHealthWarning[];
+    /** Convenience: true when there are no warnings at all. */
+    ok: boolean;
+}
+export interface PipelineHealthAgentRef {
+    id: string;
+    name?: string | null;
+    status: string;
+}
+export interface PipelineHealthStageRef {
+    key: string;
+    name: string;
+    kind?: string;
+    config?: Record<string, unknown> | null;
+}
+export interface PipelineHealthPipelineRef {
+    id: string;
+    name: string;
+    stages: PipelineHealthStageRef[];
+}
+export interface PipelineHealthStageInput {
+    id: string;
+    key: string;
+    name: string;
+    kind: string;
+    config: Record<string, unknown> | null | undefined;
+    /** Latest instructions body for the stage ("" when there are none). */
+    instructionsBody?: string | null;
+}
+export interface PipelineHealthFailedAutomationInput {
+    stageId: string;
+    stageKey: string;
+    stageName: string;
+    caseId: string;
+    caseTitle: string;
+    error?: string | null;
+}
+export interface PipelineHealthInput {
+    pipelineId: string;
+    stages: PipelineHealthStageInput[];
+    /** Every agent in the company, keyed by id, for invokability + name lookup. */
+    agentsById: Record<string, PipelineHealthAgentRef>;
+    /** Every pipeline in the company, keyed by id, for validating `/pipeline:` references. */
+    pipelinesById: Record<string, PipelineHealthPipelineRef>;
+    /** Failed stage automation still affecting live items in this pipeline. */
+    failedAutomations?: PipelineHealthFailedAutomationInput[];
+}
+export declare function isPipelineTerminalStageKind(kind: string | null | undefined): boolean;
+export declare function computePipelineHealth(input: PipelineHealthInput): PipelineHealthReport;
+/** Group a flat warning list by stage id — handy for rendering per-stage badges. */
+export declare function groupWarningsByStage(warnings: PipelineHealthWarning[]): Record<string, PipelineHealthWarning[]>;
+//# sourceMappingURL=pipeline-health.d.ts.map

package/dist/pipeline-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-health.d.ts","sourceRoot":"","sources":["../src/pipeline-health.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,yBAAyB,GACjC,cAAc,GACd,qBAAqB,GACrB,4BAA4B,GAC5B,qBAAqB,GACrB,mBAAmB,GACnB,oBAAoB,GACpB,4BAA4B,GAC5B,yBAAyB,GACzB,0BAA0B,GAC1B,mBAAmB,GACnB,iCAAiC,GACjC,0BAA0B,GAC1B,yBAAyB,CAAC;AAE9B,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,IAAI,EAAE,yBAAyB,CAAC;IAChC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,2DAA2D;IAC3D,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,mCAAmC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACnD,0FAA0F;IAC1F,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IACzD,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,mCAAmC,EAAE,CAAC;CAC3D;AAeD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEpF;AA0ED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CA4KtF;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,qBAAqB,EAAE,GAChC,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAMzC"}

package/dist/pipeline-health.js

@@ -0,0 +1,249 @@
+import { isAgentStatusInvokable } from "./agent-eligibility.js";
+import { extractPipelineMentions } from "./project-mentions.js";
+export function isPipelineTerminalStageKind(kind) {
+    return kind === "done" || kind === "cancelled";
+}
+function asConfig(config) {
+    if (!config || typeof config !== "object" || Array.isArray(config))
+        return {};
+    return config;
+}
+function agentLabel(agent) {
+    const name = agent?.name?.trim();
+    return name && name.length > 0 ? name : "a teammate";
+}
+function hasOnEnterRoutineAutomation(config) {
+    const onEnter = config.onEnter;
+    if (!onEnter || typeof onEnter !== "object" || Array.isArray(onEnter))
+        return false;
+    const record = onEnter;
+    return record.type === "run_routine" && typeof record.routineId === "string" && record.routineId.trim().length > 0;
+}
+function hasChildrenGateAutoAdvance(config) {
+    const breakdown = readBreakdownConfig(config);
+    if (breakdown)
+        return breakdown.waitForPieces && breakdown.whenFinishedMoveTo !== null;
+    return config.requireChildrenTerminal === true &&
+        typeof config.autoAdvanceOnChildrenTerminal === "string" &&
+        config.autoAdvanceOnChildrenTerminal.trim().length > 0;
+}
+/** True when a stage has saved automation that can move work forward. */
+function hasRunnableStageAutomation(config) {
+    return readBreakdownConfig(config) !== null || hasOnEnterRoutineAutomation(config) || hasChildrenGateAutoAdvance(config);
+}
+function automationAssigneeAgentId(config) {
+    const automation = config.automation;
+    if (automation && typeof automation === "object" && !Array.isArray(automation)) {
+        const value = automation.assigneeAgentId;
+        if (typeof value === "string" && value.trim())
+            return value.trim();
+    }
+    return typeof config.assigneeAgentId === "string" && config.assigneeAgentId.trim()
+        ? config.assigneeAgentId.trim()
+        : null;
+}
+function readBreakdownConfig(config) {
+    const raw = config.breakdown;
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const record = raw;
+    const targetPipelineId = typeof record.targetPipelineId === "string" && record.targetPipelineId.trim()
+        ? record.targetPipelineId.trim()
+        : null;
+    const targetStageKey = typeof record.targetStageKey === "string" && record.targetStageKey.trim()
+        ? record.targetStageKey.trim()
+        : null;
+    const pieceNoun = typeof record.pieceNoun === "string" && record.pieceNoun.trim()
+        ? record.pieceNoun.trim()
+        : "piece";
+    const inheritFields = Array.isArray(record.inheritFields)
+        ? record.inheritFields.filter((field) => typeof field === "string" && field.trim().length > 0).map((field) => field.trim())
+        : [];
+    const whenFinishedMoveTo = typeof record.whenFinishedMoveTo === "string" && record.whenFinishedMoveTo.trim()
+        ? record.whenFinishedMoveTo.trim()
+        : typeof config.autoAdvanceOnChildrenTerminal === "string" && config.autoAdvanceOnChildrenTerminal.trim()
+            ? config.autoAdvanceOnChildrenTerminal.trim()
+            : null;
+    return {
+        targetPipelineId,
+        targetStageKey,
+        pieceNoun,
+        inheritFields,
+        waitForPieces: record.waitForPieces === undefined ? config.requireChildrenTerminal === true : record.waitForPieces === true,
+        whenFinishedMoveTo,
+    };
+}
+export function computePipelineHealth(input) {
+    const warnings = [];
+    for (const stage of input.stages) {
+        const config = asConfig(stage.config);
+        const instructionsBody = (stage.instructionsBody ?? "").trim();
+        const anchor = { stageId: stage.id, stageKey: stage.key, stageName: stage.name };
+        const assigneeAgentId = automationAssigneeAgentId(config);
+        const hasStageAutomation = hasRunnableStageAutomation(config);
+        const isTerminalStage = isPipelineTerminalStageKind(stage.kind);
+        const breakdown = readBreakdownConfig(config);
+        // 1. A teammate is assigned to run this step, but they're paused / gone.
+        if (assigneeAgentId) {
+            const agent = input.agentsById[assigneeAgentId];
+            if (!agent) {
+                warnings.push({
+                    ...anchor,
+                    code: "paused_agent",
+                    message: `Assigned to a teammate who's no longer here. Pick someone else to run this step.`,
+                });
+            }
+            else if (!isAgentStatusInvokable(agent.status)) {
+                warnings.push({
+                    ...anchor,
+                    code: "paused_agent",
+                    message: `${agentLabel(agent)} is paused, so this step won't run until they're back. Reassign it if you can't wait.`,
+                });
+            }
+        }
+        // 2. A teammate is assigned but there's nothing for them to do (no instructions).
+        if (assigneeAgentId && !instructionsBody) {
+            warnings.push({
+                ...anchor,
+                code: "automation_no_instructions",
+                message: `Assigned to a teammate, but there are no instructions yet. Add instructions so this step doesn't stall.`,
+            });
+        }
+        // 3. Instructions exist, but no teammate is assigned to run them.
+        if (!assigneeAgentId && instructionsBody && !hasStageAutomation && stage.kind !== "review" && !isTerminalStage) {
+            warnings.push({
+                ...anchor,
+                code: "automation_no_agent",
+                message: `This step has instructions, but no agent is assigned. Add an agent to run this step, or make it a review step if a person should decide.`,
+            });
+        }
+        // 4. Nothing runs here automatically. This is legal, but must be loud.
+        if (!assigneeAgentId && !instructionsBody && !hasStageAutomation && stage.kind !== "review" && !isTerminalStage) {
+            warnings.push({
+                ...anchor,
+                code: "stage_no_automation",
+                message: `Nothing runs here automatically — items will sit until a person moves them. Add an agent to run this step, or make it a review step if a person should decide.`,
+            });
+        }
+        // 5. A review step with no one who can actually approve.
+        if (stage.kind === "review" || config.requireApproval === true) {
+            const approver = config.approver && typeof config.approver === "object" ? config.approver : null;
+            const kind = approver && typeof approver.kind === "string" ? approver.kind : "any_human";
+            const approverId = approver && typeof approver.id === "string" && approver.id.trim() ? approver.id.trim() : null;
+            if (kind === "agent") {
+                const agent = approverId ? input.agentsById[approverId] : undefined;
+                if (!approverId || !agent) {
+                    warnings.push({
+                        ...anchor,
+                        code: "review_no_approver",
+                        message: `No approver picked yet, so work will pile up here. Choose who approves.`,
+                    });
+                }
+                else if (!isAgentStatusInvokable(agent.status)) {
+                    warnings.push({
+                        ...anchor,
+                        code: "review_no_approver",
+                        message: `${agentLabel(agent)} is the approver and they're paused, so nothing can be approved until they're back.`,
+                    });
+                }
+            }
+            else if (kind === "user" && !approverId) {
+                warnings.push({
+                    ...anchor,
+                    code: "review_no_approver",
+                    message: `No approver picked yet, so work will pile up here. Choose who approves.`,
+                });
+            }
+        }
+        // 6. First-class breakdown references. These replace prose scanning on
+        // breakdown stages because the target workflow is now config, not copy.
+        if (breakdown) {
+            const target = breakdown.targetPipelineId ? input.pipelinesById[breakdown.targetPipelineId] : undefined;
+            const targetStage = breakdown.targetStageKey
+                ? target?.stages.find((s) => s.key === breakdown.targetStageKey)
+                : undefined;
+            if (!target || !targetStage) {
+                warnings.push({
+                    ...anchor,
+                    code: "breakdown_target_missing",
+                    message: `This step breaks work into another workflow, but that destination is missing. Pick where the pieces should go.`,
+                });
+            }
+            else {
+                if (!breakdown.waitForPieces || !breakdown.whenFinishedMoveTo) {
+                    warnings.push({
+                        ...anchor,
+                        code: "breakdown_no_wait",
+                        message: `This step creates ${breakdown.pieceNoun}s but does not wait for them before moving on. Turn on waiting if the next step depends on the pieces finishing.`,
+                    });
+                }
+                const targetConfig = asConfig(targetStage.config);
+                const firstStage = target.stages[0];
+                if (firstStage?.key !== targetStage.key ||
+                    targetStage.kind === "review" ||
+                    isPipelineTerminalStageKind(targetStage.kind) ||
+                    targetConfig.disabled === true ||
+                    targetConfig.requireApproval === true) {
+                    warnings.push({
+                        ...anchor,
+                        code: "breakdown_target_not_entry_safe",
+                        message: `New ${breakdown.pieceNoun}s start in a destination step that may not accept new work cleanly. Choose the entry step for that workflow.`,
+                    });
+                }
+            }
+        }
+        else if (instructionsBody) {
+            for (const mention of extractPipelineMentions(instructionsBody)) {
+                const target = input.pipelinesById[mention.pipelineId];
+                if (!target) {
+                    warnings.push({
+                        ...anchor,
+                        code: "missing_pipeline_reference",
+                        message: `These instructions hand off to a workflow that's been deleted. Point them at one that exists.`,
+                    });
+                    continue;
+                }
+                if (mention.stageKey && !target.stages.some((s) => s.key === mention.stageKey)) {
+                    warnings.push({
+                        ...anchor,
+                        code: "missing_stage_reference",
+                        message: `These instructions hand off to a step that no longer exists in "${target.name}". Point them at one that does.`,
+                    });
+                }
+            }
+        }
+        // 7. Required stage variables are item inputs, not settings defaults.
+        // Missing per-item values are validated when work enters or runs through
+        // the pipeline; a blank default in settings is a normal configuration.
+    }
+    const seenFailedAutomationCaseIdsByStage = new Map();
+    for (const failure of input.failedAutomations ?? []) {
+        let seenCaseIds = seenFailedAutomationCaseIdsByStage.get(failure.stageId);
+        if (!seenCaseIds) {
+            seenCaseIds = new Set();
+            seenFailedAutomationCaseIdsByStage.set(failure.stageId, seenCaseIds);
+        }
+        if (seenCaseIds.has(failure.caseId))
+            continue;
+        seenCaseIds.add(failure.caseId);
+        warnings.push({
+            code: "automation_failed",
+            stageId: failure.stageId,
+            stageKey: failure.stageKey,
+            stageName: failure.stageName,
+            message: `Automation failed on "${failure.caseTitle}". Open the item to inspect the log and retry it.`,
+            href: `/pipelines/${input.pipelineId}/items/${failure.caseId}`,
+            hrefLabel: "Open item",
+        });
+    }
+    return { pipelineId: input.pipelineId, warnings, ok: warnings.length === 0 };
+}
+/** Group a flat warning list by stage id — handy for rendering per-stage badges. */
+export function groupWarningsByStage(warnings) {
+    const byStage = {};
+    for (const warning of warnings) {
+        (byStage[warning.stageId] ??= []).push(warning);
+    }
+    return byStage;
+}
+//# sourceMappingURL=pipeline-health.js.map

package/dist/pipeline-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-health.js","sourceRoot":"","sources":["../src/pipeline-health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAiHhE,MAAM,UAAU,2BAA2B,CAAC,IAA+B;IACzE,OAAO,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,WAAW,CAAC;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,MAA0C;IAC1D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9E,OAAO,MAAqB,CAAC;AAC/B,CAAC;AAED,SAAS,UAAU,CAAC,KAAyC;IAC3D,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACjC,OAAO,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;AACvD,CAAC;AAED,SAAS,2BAA2B,CAAC,MAAmB;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACpF,MAAM,MAAM,GAAG,OAAkC,CAAC;IAClD,OAAO,MAAM,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACrH,CAAC;AAED,SAAS,0BAA0B,CAAC,MAAmB;IACrD,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,aAAa,IAAI,SAAS,CAAC,kBAAkB,KAAK,IAAI,CAAC;IACvF,OAAO,MAAM,CAAC,uBAAuB,KAAK,IAAI;QAC5C,OAAO,MAAM,CAAC,6BAA6B,KAAK,QAAQ;QACxD,MAAM,CAAC,6BAA6B,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,yEAAyE;AACzE,SAAS,0BAA0B,CAAC,MAAmB;IACrD,OAAO,mBAAmB,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,2BAA2B,CAAC,MAAM,CAAC,IAAI,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAC3H,CAAC;AAED,SAAS,yBAAyB,CAAC,MAAmB;IACpD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,IAAI,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/E,MAAM,KAAK,GAAI,UAAsC,CAAC,eAAe,CAAC;QACtE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;YAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACrE,CAAC;IACD,OAAO,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ,IAAI,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAChF,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAC/B,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAmB;IAC9C,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC;IAC7B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvE,MAAM,MAAM,GAAG,GAA8B,CAAC;IAC9C,MAAM,gBAAgB,GAAG,OAAO,MAAM,CAAC,gBAAgB,KAAK,QAAQ,IAAI,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;QACpG,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAChC,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,cAAc,GAAG,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,IAAI,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE;QAC9F,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE;QAC9B,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;QAC/E,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;QACzB,CAAC,CAAC,OAAO,CAAC;IACZ,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC;QACvD,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5I,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,kBAAkB,GAAG,OAAO,MAAM,CAAC,kBAAkB,KAAK,QAAQ,IAAI,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE;QAC1G,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE;QAClC,CAAC,CAAC,OAAO,MAAM,CAAC,6BAA6B,KAAK,QAAQ,IAAI,MAAM,CAAC,6BAA6B,CAAC,IAAI,EAAE;YACvG,CAAC,CAAC,MAAM,CAAC,6BAA6B,CAAC,IAAI,EAAE;YAC7C,CAAC,CAAC,IAAI,CAAC;IACX,OAAO;QACL,gBAAgB;QAChB,cAAc;QACd,SAAS;QACT,aAAa;QACb,aAAa,EAAE,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,uBAAuB,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,KAAK,IAAI;QAC3H,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAA0B;IAC9D,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,gBAAgB,GAAG,CAAC,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QAEjF,MAAM,eAAe,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,eAAe,GAAG,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAE9C,yEAAyE;QACzE,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;YAChD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,QAAQ,CAAC,IAAI,CAAC;oBACZ,GAAG,MAAM;oBACT,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,kFAAkF;iBAC5F,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjD,QAAQ,CAAC,IAAI,CAAC;oBACZ,GAAG,MAAM;oBACT,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,uFAAuF;iBACrH,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,kFAAkF;QAClF,IAAI,eAAe,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACzC,QAAQ,CAAC,IAAI,CAAC;gBACZ,GAAG,MAAM;gBACT,IAAI,EAAE,4BAA4B;gBAClC,OAAO,EAAE,yGAAyG;aACnH,CAAC,CAAC;QACL,CAAC;QAED,kEAAkE;QAClE,IAAI,CAAC,eAAe,IAAI,gBAAgB,IAAI,CAAC,kBAAkB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,eAAe,EAAE,CAAC;YAC/G,QAAQ,CAAC,IAAI,CAAC;gBACZ,GAAG,MAAM;gBACT,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,0IAA0I;aACpJ,CAAC,CAAC;QACL,CAAC;QAED,uEAAuE;QACvE,IAAI,CAAC,eAAe,IAAI,CAAC,gBAAgB,IAAI,CAAC,kBAAkB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,eAAe,EAAE,CAAC;YAChH,QAAQ,CAAC,IAAI,CAAC;gBACZ,GAAG,MAAM;gBACT,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,gKAAgK;aAC1K,CAAC,CAAC;QACL,CAAC;QAED,yDAAyD;QACzD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;YAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;YACjG,MAAM,IAAI,GAAG,QAAQ,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;YACzF,MAAM,UAAU,GACd,QAAQ,IAAI,OAAO,QAAQ,CAAC,EAAE,KAAK,QAAQ,IAAI,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAChG,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACpE,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC1B,QAAQ,CAAC,IAAI,CAAC;wBACZ,GAAG,MAAM;wBACT,IAAI,EAAE,oBAAoB;wBAC1B,OAAO,EAAE,yEAAyE;qBACnF,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;oBACjD,QAAQ,CAAC,IAAI,CAAC;wBACZ,GAAG,MAAM;wBACT,IAAI,EAAE,oBAAoB;wBAC1B,OAAO,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,qFAAqF;qBACnH,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC1C,QAAQ,CAAC,IAAI,CAAC;oBACZ,GAAG,MAAM;oBACT,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,yEAAyE;iBACnF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,uEAAuE;QACvE,wEAAwE;QACxE,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACxG,MAAM,WAAW,GAAG,SAAS,CAAC,cAAc;gBAC1C,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,cAAc,CAAC;gBAChE,CAAC,CAAC,SAAS,CAAC;YACd,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC5B,QAAQ,CAAC,IAAI,CAAC;oBACZ,GAAG,MAAM;oBACT,IAAI,EAAE,0BAA0B;oBAChC,OAAO,EAAE,gHAAgH;iBAC1H,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,SAAS,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC;oBAC9D,QAAQ,CAAC,IAAI,CAAC;wBACZ,GAAG,MAAM;wBACT,IAAI,EAAE,mBAAmB;wBACzB,OAAO,EAAE,qBAAqB,SAAS,CAAC,SAAS,kHAAkH;qBACpK,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM,YAAY,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBAClD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACpC,IACE,UAAU,EAAE,GAAG,KAAK,WAAW,CAAC,GAAG;oBACnC,WAAW,CAAC,IAAI,KAAK,QAAQ;oBAC7B,2BAA2B,CAAC,WAAW,CAAC,IAAI,CAAC;oBAC7C,YAAY,CAAC,QAAQ,KAAK,IAAI;oBAC9B,YAAY,CAAC,eAAe,KAAK,IAAI,EACrC,CAAC;oBACD,QAAQ,CAAC,IAAI,CAAC;wBACZ,GAAG,MAAM;wBACT,IAAI,EAAE,iCAAiC;wBACvC,OAAO,EAAE,OAAO,SAAS,CAAC,SAAS,8GAA8G;qBAClJ,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,gBAAgB,EAAE,CAAC;YAC5B,KAAK,MAAM,OAAO,IAAI,uBAAuB,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAChE,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACvD,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,QAAQ,CAAC,IAAI,CAAC;wBACZ,GAAG,MAAM;wBACT,IAAI,EAAE,4BAA4B;wBAClC,OAAO,EAAE,+FAA+F;qBACzG,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;gBACD,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC/E,QAAQ,CAAC,IAAI,CAAC;wBACZ,GAAG,MAAM;wBACT,IAAI,EAAE,yBAAyB;wBAC/B,OAAO,EAAE,mEAAmE,MAAM,CAAC,IAAI,iCAAiC;qBACzH,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,sEAAsE;QACtE,yEAAyE;QACzE,uEAAuE;IACzE,CAAC;IAED,MAAM,kCAAkC,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC1E,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,EAAE,CAAC;QACpD,IAAI,WAAW,GAAG,kCAAkC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1E,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;YAChC,kCAAkC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,SAAS;QAC9C,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAChC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,yBAAyB,OAAO,CAAC,SAAS,mDAAmD;YACtG,IAAI,EAAE,cAAc,KAAK,CAAC,UAAU,UAAU,OAAO,CAAC,MAAM,EAAE;YAC9D,SAAS,EAAE,WAAW;SACvB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAClC,QAAiC;IAEjC,MAAM,OAAO,GAA4C,EAAE,CAAC;IAC5D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/pipeline-health.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipeline-health.test.d.ts.map

package/dist/pipeline-health.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-health.test.d.ts","sourceRoot":"","sources":["../src/pipeline-health.test.ts"],"names":[],"mappings":""}

package/dist/pipeline-health.test.js

@@ -0,0 +1,140 @@
+import { describe, expect, it } from "vitest";
+import { computePipelineHealth, } from "./pipeline-health.js";
+describe("computePipelineHealth", () => {
+    const baseInput = {
+        pipelineId: "pipeline-1",
+        stages: [],
+        agentsById: {},
+        pipelinesById: {},
+    };
+    it("emits one warning per failed automation item and stage", () => {
+        const failure = {
+            stageId: "stage-1",
+            stageKey: "build",
+            stageName: "Build",
+            caseId: "case-1",
+            caseTitle: "Case 1",
+            error: "Routine timed out",
+        };
+        const report = computePipelineHealth({
+            ...baseInput,
+            failedAutomations: [failure],
+        });
+        expect(report.warnings).toHaveLength(1);
+        expect(report.warnings[0]).toMatchObject({
+            code: "automation_failed",
+            stageId: "stage-1",
+            stageKey: "build",
+            stageName: "Build",
+            href: "/pipelines/pipeline-1/items/case-1",
+            hrefLabel: "Open item",
+            message: `Automation failed on "Case 1". Open the item to inspect the log and retry it.`,
+        });
+    });
+    it("deduplicates duplicate failed automation rows for the same stage and case", () => {
+        const failure = {
+            stageId: "stage-1",
+            stageKey: "build",
+            stageName: "Build",
+            caseId: "case-1",
+            caseTitle: "Case 1",
+            error: "Routine timed out",
+        };
+        const duplicateFailure = {
+            stageId: "stage-1",
+            stageKey: "build",
+            stageName: "Build",
+            caseId: "case-1",
+            caseTitle: "Case 1",
+            error: "Routine timed out",
+        };
+        const report = computePipelineHealth({
+            ...baseInput,
+            failedAutomations: [failure, duplicateFailure],
+        });
+        const automationWarnings = report.warnings.filter((warning) => warning.code === "automation_failed");
+        expect(automationWarnings).toHaveLength(1);
+    });
+    it("keeps separate warnings for different case IDs in the same stage", () => {
+        const firstFailure = {
+            stageId: "stage-1",
+            stageKey: "build",
+            stageName: "Build",
+            caseId: "case-1",
+            caseTitle: "Case 1",
+            error: "Routine timed out",
+        };
+        const secondFailure = {
+            stageId: "stage-1",
+            stageKey: "build",
+            stageName: "Build",
+            caseId: "case-2",
+            caseTitle: "Case 2",
+            error: "Routine timed out",
+        };
+        const report = computePipelineHealth({
+            ...baseInput,
+            failedAutomations: [firstFailure, secondFailure],
+        });
+        const automationWarnings = report.warnings.filter((warning) => warning.code === "automation_failed");
+        expect(automationWarnings).toHaveLength(2);
+        expect(automationWarnings.map((warning) => warning.href)).toEqual([
+            "/pipelines/pipeline-1/items/case-1",
+            "/pipelines/pipeline-1/items/case-2",
+        ]);
+    });
+    it("keeps separate warnings for the same case ID in different stages", () => {
+        const firstFailure = {
+            stageId: "stage-1",
+            stageKey: "build",
+            stageName: "Build",
+            caseId: "case-1",
+            caseTitle: "Case 1",
+            error: "Routine timed out",
+        };
+        const secondFailure = {
+            stageId: "stage-2",
+            stageKey: "verify",
+            stageName: "Verify",
+            caseId: "case-1",
+            caseTitle: "Case 1",
+            error: "Routine timed out",
+        };
+        const report = computePipelineHealth({
+            ...baseInput,
+            failedAutomations: [firstFailure, secondFailure],
+        });
+        const automationWarnings = report.warnings.filter((warning) => warning.code === "automation_failed");
+        expect(automationWarnings).toHaveLength(2);
+        expect(automationWarnings.map((warning) => warning.stageId)).toEqual(["stage-1", "stage-2"]);
+    });
+    it("keeps separate warnings when stage and case IDs would collide with colon-delimited keys", () => {
+        const firstFailure = {
+            stageId: "stage:one",
+            stageKey: "build",
+            stageName: "Build",
+            caseId: "case",
+            caseTitle: "Case 1",
+            error: "Routine timed out",
+        };
+        const secondFailure = {
+            stageId: "stage",
+            stageKey: "verify",
+            stageName: "Verify",
+            caseId: "one:case",
+            caseTitle: "Case 2",
+            error: "Routine timed out",
+        };
+        const report = computePipelineHealth({
+            ...baseInput,
+            failedAutomations: [firstFailure, secondFailure],
+        });
+        const automationWarnings = report.warnings.filter((warning) => warning.code === "automation_failed");
+        expect(automationWarnings).toHaveLength(2);
+        expect(automationWarnings.map((warning) => warning.href)).toEqual([
+            "/pipelines/pipeline-1/items/case",
+            "/pipelines/pipeline-1/items/one:case",
+        ]);
+    });
+});
+//# sourceMappingURL=pipeline-health.test.js.map

package/dist/pipeline-health.test.js.map

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

package/dist/portability-fidelity.d.ts

@@ -0,0 +1,19 @@
+export type PortabilityFidelitySeverity = "info" | "warning" | "blocker";
+export interface PortabilityFidelityWarning {
+    code: string;
+    severity: PortabilityFidelitySeverity;
+    message: string;
+}
+export declare const EXPORT_FIDELITY_REPORT_SCHEMA = "paperclip-export-fidelity-v1";
+export declare const EXPORT_FIDELITY_COUNT_KEYS: readonly ["labelDefinitions", "issueLabelReferences", "issueBlockerRelations", "issueDocuments", "issueWorkProducts", "issueAttachments", "approvals", "costEvents", "activityLogEntries", "issueMonitors"];
+export type ExportFidelityCounts = Record<(typeof EXPORT_FIDELITY_COUNT_KEYS)[number], number>;
+export interface ExportFidelityReport {
+    schema: typeof EXPORT_FIDELITY_REPORT_SCHEMA;
+    companyId: string;
+    counts: ExportFidelityCounts;
+    warnings: PortabilityFidelityWarning[];
+    generatedAt: string;
+}
+export declare function buildExportFidelityWarnings(counts: ExportFidelityCounts): PortabilityFidelityWarning[];
+export declare function normalizeExportFidelityCounts(value: unknown): ExportFidelityCounts | null;
+//# sourceMappingURL=portability-fidelity.d.ts.map

package/dist/portability-fidelity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portability-fidelity.d.ts","sourceRoot":"","sources":["../src/portability-fidelity.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,2BAA2B,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,6BAA6B,iCAAiC,CAAC;AAE5E,eAAO,MAAM,0BAA0B,YACrC,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,eAAe,CACP,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAE/F,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,6BAA6B,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,oBAAoB,GAAG,0BAA0B,EAAE,CAYtG;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAUzF"}

package/dist/portability-fidelity.js

@@ -0,0 +1,46 @@
+export const EXPORT_FIDELITY_REPORT_SCHEMA = "paperclip-export-fidelity-v1";
+export const EXPORT_FIDELITY_COUNT_KEYS = [
+    "labelDefinitions",
+    "issueLabelReferences",
+    "issueBlockerRelations",
+    "issueDocuments",
+    "issueWorkProducts",
+    "issueAttachments",
+    "approvals",
+    "costEvents",
+    "activityLogEntries",
+    "issueMonitors",
+];
+const UNSUPPORTED_DATA_WARNINGS = [
+    ["approvals_not_exported", "approvals", "approval", "approvals"],
+    ["cost_history_not_exported", "costEvents", "cost event", "cost events"],
+    ["activity_history_not_exported", "activityLogEntries", "activity log entry", "activity log entries"],
+];
+export function buildExportFidelityWarnings(counts) {
+    const warnings = [];
+    for (const [code, countKey, singular, plural] of UNSUPPORTED_DATA_WARNINGS) {
+        const rowCount = counts[countKey];
+        if (rowCount <= 0)
+            continue;
+        warnings.push({
+            code,
+            severity: "warning",
+            message: `${rowCount} ${rowCount === 1 ? `${singular} is` : `${plural} are`} not included in the export bundle.`,
+        });
+    }
+    return warnings;
+}
+export function normalizeExportFidelityCounts(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const record = value;
+    const counts = {};
+    for (const key of EXPORT_FIDELITY_COUNT_KEYS) {
+        const raw = record[key];
+        if (typeof raw !== "number" || !Number.isFinite(raw) || raw < 0)
+            return null;
+        counts[key] = raw;
+    }
+    return counts;
+}
+//# sourceMappingURL=portability-fidelity.js.map

package/dist/portability-fidelity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portability-fidelity.js","sourceRoot":"","sources":["../src/portability-fidelity.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,6BAA6B,GAAG,8BAA8B,CAAC;AAE5E,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,kBAAkB;IAClB,sBAAsB;IACtB,uBAAuB;IACvB,gBAAgB;IAChB,mBAAmB;IACnB,kBAAkB;IAClB,WAAW;IACX,YAAY;IACZ,oBAAoB;IACpB,eAAe;CACP,CAAC;AAYX,MAAM,yBAAyB,GAA0G;IACvI,CAAC,wBAAwB,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC;IAChE,CAAC,2BAA2B,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,CAAC;IACxE,CAAC,+BAA+B,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,sBAAsB,CAAC;CACtG,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,MAA4B;IACtE,MAAM,QAAQ,GAAiC,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,yBAAyB,EAAE,CAAC;QAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,QAAQ,IAAI,CAAC;YAAE,SAAS;QAC5B,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI;YACJ,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,GAAG,QAAQ,IAAI,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,MAAM,qCAAqC;SACjH,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAc;IAC1D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,MAAM,GAAG,EAAiE,CAAC;IACjF,KAAK,MAAM,GAAG,IAAI,0BAA0B,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7E,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/portability-fidelity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=portability-fidelity.test.d.ts.map

package/dist/portability-fidelity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portability-fidelity.test.d.ts","sourceRoot":"","sources":["../src/portability-fidelity.test.ts"],"names":[],"mappings":""}