/**
 * Pipeline lint rules — static gotcha checks for pipeline JSON.
 *
 * Catches documented failure modes that pass JSON syntax validation but
 * silently misbehave at runtime. Run before `workflows validate` to skip
 * the API round-trip for the most common authoring mistakes.
 *
 * See docs/GOTCHAS.md (also embedded in workspace-folder.ts) for the full
 * write-up of each rule.
 */
export interface LintIssue {
    severity: 'error' | 'warning';
    code: string;
    message: string;
    stepId?: string;
    hint?: string;
}
type Pipeline = Record<string, unknown>;
export declare function lintPipeline(pipeline: Pipeline): LintIssue[];
export {};