/** Relative path from workspace root to maintainer phase snapshot (dashboard + doctor). */
export declare const WORKSPACE_KIT_STATUS_YAML_RELATIVE = "docs/maintainers/data/workspace-kit-status.yaml";
/** Best-effort parse of maintainer status YAML for dashboard UIs (no full YAML dependency). */
export type WorkspaceStatusSnapshot = {
    currentKitPhase: string | null;
    /** Maintainer-maintained `next_kit_phase` in workspace-kit-status.yaml; null when unset. */
    nextKitPhase: string | null;
    /** Maintainer narrative; still returned for tooling — dashboard UI prefers `nextAgentActions` + phases. */
    activeFocus: string | null;
    lastUpdated: string | null;
    blockers: string[];
    pendingDecisions: string[];
    nextAgentActions: string[];
};
/**
 * Parse `docs/maintainers/data/workspace-kit-status.yaml` contents (tests + internal).
 * Tolerant: list keys use the repo’s usual `- "..."` list items; unknown shapes yield empty arrays.
 */
export declare function parseWorkspaceKitStatusYaml(raw: string): WorkspaceStatusSnapshot;
/** Escape inner string for a double-quoted YAML scalar on one line. */
export declare function escapeWorkspaceKitStatusYamlDoubleQuoted(value: string): string;
/**
 * True when `value` is safe for `current_kit_phase` / `next_kit_phase` single-line scalars.
 * Rejects empty, control characters, and newlines.
 */
export declare function isValidWorkspacePhaseSnapshotValue(value: string): boolean;
export type WorkspacePhaseSnapshotYamlUpdates = {
    currentKitPhase?: string;
    /** When present and `null`, removes the `next_kit_phase` line entirely. */
    nextKitPhase?: string | null;
};
export type ApplyWorkspacePhaseSnapshotYamlResult = {
    ok: true;
    yaml: string;
} | {
    ok: false;
    message: string;
};
/**
 * Replace only `current_kit_phase` and/or `next_kit_phase` top-level lines; all other bytes unchanged.
 * Does not parse full YAML — assumes repo-style single-line scalars for these keys.
 */
export declare function applyWorkspacePhaseSnapshotToYaml(raw: string, updates: WorkspacePhaseSnapshotYamlUpdates): ApplyWorkspacePhaseSnapshotYamlResult;
export declare function readWorkspaceStatusSnapshot(workspacePath: string): Promise<WorkspaceStatusSnapshot | null>;
