pharos_native/runtime/

business.rs

use serde_json::{Map, Value};
use sha2::{Digest, Sha256};
use std::env;
use std::fs;
use std::path::Path;

use crate::config::AppRuntime;

use super::generated;
use super::json_commands::request_booking_options_json_from_form;

/// Renders the technician fragment through the app-owned template adapter.
pub fn maybe_write_technician_hx_booking_local(
    root: &Value,
    business_slug: &str,
    app_root: &Path,
) -> Option<String> {
    dynamic_business_admin_technician_rows_html_from_root(root, business_slug, app_root)
}

/// Renders the technician management fragment through the app-owned template adapter.
pub fn maybe_write_technician_hx_response_management_local(
    root: &Value,
    business_slug: &str,
    app_root: &Path,
) -> Option<String> {
    dynamic_business_admin_technician_rows_html_from_root(root, business_slug, app_root)
}

pub use pharos_runtime_business::*;

/// Converts booking-option fields from an URL-encoded or multipart form.
///
/// # Parameters
///
/// - `content_type`: Input consumed by [`crate::runtime::business::dynamic_booking_options_json_from_form`].
/// - `form_body`: Input consumed by [`crate::runtime::business::dynamic_booking_options_json_from_form`].
/// - `body_path`: Input consumed by [`crate::runtime::business::dynamic_booking_options_json_from_form`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::dynamic_booking_options_json_from_form`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dynamic_booking_options_json_from_form(todo!(), "name=value", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dynamic_booking_options_json_from_form(
    content_type: Option<&str>,
    form_body: Option<&str>,
    body_path: Option<&Path>,
) -> Option<String> {
    if form_body.is_some_and(|body| body.len() > MAX_INPUT_BYTES)
        || body_path.is_some_and(|path| {
            path.metadata()
                .map(|metadata| metadata.len() > MAX_INPUT_BYTES as u64)
                .unwrap_or(false)
        })
    {
        return None;
    }
    request_booking_options_json_from_form(content_type, form_body, body_path)
        .and_then(|text| (text.len() <= MAX_JSON_BYTES).then_some(text))
}

/// Appends one validated adapter delivery to an in-memory state root and returns.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::dynamic_integrations_deliver_report_json`].
/// - `integrations_root`: Input consumed by [`crate::runtime::business::dynamic_integrations_deliver_report_json`].
/// - `adapter_id`: Input consumed by [`crate::runtime::business::dynamic_integrations_deliver_report_json`].
/// - `event_kind`: Input consumed by [`crate::runtime::business::dynamic_integrations_deliver_report_json`].
/// - `resource_id`: Input consumed by [`crate::runtime::business::dynamic_integrations_deliver_report_json`].
/// - `tenant_id`: Input consumed by [`crate::runtime::business::dynamic_integrations_deliver_report_json`].
/// - `subject_id`: Input consumed by [`crate::runtime::business::dynamic_integrations_deliver_report_json`].
/// - `payload_json`: Input consumed by [`crate::runtime::business::dynamic_integrations_deliver_report_json`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::dynamic_integrations_deliver_report_json`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dynamic_integrations_deliver_report_json(std::path::Path::new("."), todo!(), todo!(), todo!(), todo!(), todo!(), todo!(), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dynamic_integrations_deliver_report_json(
    root: &mut Value,
    integrations_root: &Value,
    adapter_id: &str,
    event_kind: Option<&str>,
    resource_id: Option<&str>,
    tenant_id: Option<&str>,
    subject_id: Option<&str>,
    payload_json: &str,
) -> Option<String> {
    if adapter_id.is_empty() || payload_json.len() > MAX_INPUT_BYTES {
        return None;
    }
    let delivery_id = super::dynamic::deliver_integration_webhook(
        root,
        integrations_root,
        adapter_id,
        event_kind,
        resource_id,
        tenant_id,
        subject_id,
        payload_json,
    )?;
    integrations_report_json(
        root,
        delivery_id,
        Some(serde_json::json!({
            "queued_delivery_count": 1,
            "delivered_webhook_count": 0,
            "retryable_webhook_count": 0,
            "failed_webhook_count": 0,
            "retried_delivery_count": 0,
        })),
    )
}

/// Reads one form field from an encoded body or a bounded request-body file.
///
/// # Parameters
///
/// - `content_type`: Input consumed by [`crate::runtime::business::request_form_field_value_business_logic_local`].
/// - `form_body`: Input consumed by [`crate::runtime::business::request_form_field_value_business_logic_local`].
/// - `body_path`: Input consumed by [`crate::runtime::business::request_form_field_value_business_logic_local`].
/// - `field_name`: Input consumed by [`crate::runtime::business::request_form_field_value_business_logic_local`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::request_form_field_value_business_logic_local`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::request_form_field_value_business_logic_local(todo!(), "name=value", todo!(), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn request_form_field_value_business_logic_local(
    content_type: Option<&str>,
    form_body: Option<&str>,
    body_path: Option<&Path>,
    field_name: &str,
) -> Option<String> {
    super::json_commands::request_form_field_value(content_type, form_body, body_path, field_name)
}

/// Appends a calendar synchronization job to a mutable job list.
///
/// # Parameters
///
/// - `jobs`: Input consumed by [`crate::runtime::business::append_google_calendar_sync_jobs_logic_local`].
/// - `payload`: Input consumed by [`crate::runtime::business::append_google_calendar_sync_jobs_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_google_calendar_sync_jobs_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_google_calendar_sync_jobs_logic_local(todo!(), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_google_calendar_sync_jobs_logic_local(jobs: &mut Value, payload: Value) -> bool {
    super::json_commands::generated_surface_append_audit_event_mut(jobs, payload)
}

/// Appends an audit record to a mutable job execution.
///
/// # Parameters
///
/// - `row`: Input consumed by [`crate::runtime::business::append_job_audit_logic_local`].
/// - `audit`: Input consumed by [`crate::runtime::business::append_job_audit_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_job_audit_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_job_audit_logic_local(todo!(), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_job_audit_logic_local(row: &mut Value, audit: Value) -> bool {
    super::json_commands::generated_surface_append_audit_event_mut(row, audit)
}

/// Performs appointment maintenance result HTML.
///
/// # Parameters
///
/// - `app_root`: Input consumed by [`crate::runtime::business::appointment_maintenance_result_html`].
/// - `results`: Input consumed by [`crate::runtime::business::appointment_maintenance_result_html`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::appointment_maintenance_result_html`] can produce a value and [`None`] otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::appointment_maintenance_result_html`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::appointment_maintenance_result_html(std::path::Path::new("apps/dev_docs"), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn appointment_maintenance_result_html(app_root: &Path, results: &[String]) -> Option<String> {
    let mut html = String::new();
    for line in results {
        html.push_str(
            &super::generated::render_generated_admin_fragment_from_value_runtime(
                app_root,
                "templates/appointments/fragments/maintenance_result_line.html",
                &serde_json::Map::from_iter([(
                    "message".to_owned(),
                    Value::String(line.to_owned()),
                )]),
            )?,
        );
    }
    Some(html)
}

/// Writes the refreshed business-availability fragment for an HTMX caller.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::maybe_write_business_availability_hx_booking_local`].
/// - `business_slug`: Input consumed by [`crate::runtime::business::maybe_write_business_availability_hx_booking_local`].
/// - `app_root`: Input consumed by [`crate::runtime::business::maybe_write_business_availability_hx_booking_local`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::maybe_write_business_availability_hx_booking_local`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::maybe_write_business_availability_hx_booking_local(std::path::Path::new("."), "demo", std::path::Path::new("apps/dev_docs"));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn maybe_write_business_availability_hx_booking_local(
    root: &Value,
    business_slug: &str,
    app_root: &Path,
) -> Option<String> {
    super::json_commands::dynamic_render_business_admin_availability_rows_html(
        root,
        business_slug,
        app_root,
    )
}

/// Writes the refreshed public-state button fragment for an HTMX caller.
///
/// # Parameters
///
/// - `_root`: Input consumed by [`crate::runtime::business::maybe_write_public_toggle_hx_response_identity_local`].
/// - `business_slug`: Input consumed by [`crate::runtime::business::maybe_write_public_toggle_hx_response_identity_local`].
/// - `is_public`: Input consumed by [`crate::runtime::business::maybe_write_public_toggle_hx_response_identity_local`].
/// - `app_root`: Input consumed by [`crate::runtime::business::maybe_write_public_toggle_hx_response_identity_local`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::maybe_write_public_toggle_hx_response_identity_local`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::maybe_write_public_toggle_hx_response_identity_local(todo!(), "demo", todo!(), std::path::Path::new("apps/dev_docs"));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn maybe_write_public_toggle_hx_response_identity_local(
    _root: &Value,
    business_slug: &str,
    is_public: bool,
    app_root: &Path,
) -> Option<String> {
    super::json_commands::dynamic_render_business_admin_public_state_button_html(
        app_root,
        business_slug,
        is_public,
    )
}

/// Updates or removes a service image URL without accepting unsafe disk paths.
///
/// # Parameters
///
/// - `service`: Input consumed by [`crate::runtime::business::update_service_image_management_local`].
/// - `remove_image`: Input consumed by [`crate::runtime::business::update_service_image_management_local`].
/// - `uploaded_media_url`: Input consumed by [`crate::runtime::business::update_service_image_management_local`].
/// - `artifact_dir`: Input consumed by [`crate::runtime::business::update_service_image_management_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::update_service_image_management_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::update_service_image_management_local(todo!(), todo!(), todo!(), std::path::Path::new("build/dev_docs"));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn update_service_image_management_local(
    service: &mut Value,
    remove_image: &str,
    uploaded_media_url: Option<&str>,
    artifact_dir: Option<&Path>,
) -> bool {
    let Some(object) = service.as_object() else {
        return false;
    };
    let existing = object
        .get("image_url")
        .and_then(Value::as_str)
        .unwrap_or_default()
        .to_owned();
    if (truthy_form_value_management_local(remove_image)
        || uploaded_media_url.is_some_and(|value| value.starts_with("/media/businesses/")))
        && let Some(artifact_dir) = artifact_dir
    {
        let _ =
            super::json_commands::dynamic_remove_business_media_url_file(artifact_dir, &existing);
    }
    update_service_image_state(service, remove_image, uploaded_media_url)
}

fn render_technician_card_input(
    app_root: &Path,
    id: &str,
    name: &str,
    label: &str,
    input_type: &str,
    class_name: &str,
    value: &str,
    attributes_html: &str,
) -> Option<String> {
    generated::render_generated_admin_fragment_from_value_runtime(
        app_root,
        "templates/shared/fragments/ui_input.html",
        &Map::from_iter([
            ("id".to_owned(), Value::String(id.to_owned())),
            (
                "input_type".to_owned(),
                Value::String(input_type.to_owned()),
            ),
            ("name".to_owned(), Value::String(name.to_owned())),
            ("label".to_owned(), Value::String(label.to_owned())),
            (
                "label_class".to_owned(),
                Value::String("sr-only".to_owned()),
            ),
            (
                "class_name".to_owned(),
                Value::String(class_name.to_owned()),
            ),
            ("value".to_owned(), Value::String(value.to_owned())),
            (
                "attributes_html".to_owned(),
                Value::String(attributes_html.to_owned()),
            ),
            ("help_html".to_owned(), Value::String(String::new())),
        ]),
    )
}

/// Renders one technician card button from the app-owned UI fragment contract.
fn render_technician_card_button(
    app_root: &Path,
    id: &str,
    button_type: &str,
    class_name: &str,
    attributes_html: &str,
    content_fragment: &str,
) -> Option<String> {
    let content_html = generated::render_generated_admin_fragment_from_value_runtime(
        app_root,
        content_fragment,
        &Map::new(),
    )?;
    generated::render_generated_admin_fragment_from_value_runtime(
        app_root,
        "templates/shared/fragments/ui_button.html",
        &Map::from_iter([
            ("id".to_owned(), Value::String(id.to_owned())),
            (
                "button_type".to_owned(),
                Value::String(button_type.to_owned()),
            ),
            (
                "class_name".to_owned(),
                Value::String(class_name.to_owned()),
            ),
            (
                "attributes_html".to_owned(),
                Value::String(attributes_html.to_owned()),
            ),
            ("content_html".to_owned(), Value::String(content_html)),
        ]),
    )
}

/// Renders one technician availability day selector from app-owned fragments.
fn render_technician_card_day_select(
    app_root: &Path,
    id: &str,
    selected_day: &str,
) -> Option<String> {
    let mut options_html = String::new();
    for day in [
        "Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun", "Weekdays", "Weekends",
    ] {
        options_html.push_str(
            &generated::render_generated_admin_fragment_from_value_runtime(
                app_root,
                "templates/shared/fragments/select_option.html",
                &Map::from_iter([
                    ("option_value".to_owned(), Value::String(day.to_owned())),
                    ("option_label".to_owned(), Value::String(day.to_owned())),
                    (
                        "selected_attr".to_owned(),
                        Value::String(
                            if day == selected_day { " selected" } else { "" }.to_owned(),
                        ),
                    ),
                ]),
            )?,
        );
    }
    generated::render_generated_admin_fragment_from_value_runtime(
        app_root,
        "templates/shared/fragments/ui_select.html",
        &Map::from_iter([
            ("id".to_owned(), Value::String(id.to_owned())),
            ("name".to_owned(), Value::String("day_of_week".to_owned())),
            ("label".to_owned(), Value::String("Day".to_owned())),
            ("label_class".to_owned(), Value::String("sr-only".to_owned())),
            ("class_name".to_owned(), Value::String("form-control form-control-compact availability-inline-input business-admin-technician-day-input".to_owned())),
            ("attributes_html".to_owned(), Value::String(" autocomplete=\"false\" aria-label=\"Day\"".to_owned())),
            ("options_html".to_owned(), Value::String(options_html)),
            ("help_html".to_owned(), Value::String(String::new())),
        ]),
    )
}

/// Builds technician cards for an already-loaded business state root.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::dynamic_business_admin_technician_rows_html_from_root`].
/// - `business_slug`: Input consumed by [`crate::runtime::business::dynamic_business_admin_technician_rows_html_from_root`].
/// - `app_root`: Input consumed by [`crate::runtime::business::dynamic_business_admin_technician_rows_html_from_root`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::dynamic_business_admin_technician_rows_html_from_root`] can produce a value and [`None`] otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::dynamic_business_admin_technician_rows_html_from_root`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dynamic_business_admin_technician_rows_html_from_root(std::path::Path::new("."), "demo", std::path::Path::new("apps/dev_docs"));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dynamic_business_admin_technician_rows_html_from_root(
    root: &Value,
    business_slug: &str,
    app_root: &Path,
) -> Option<String> {
    let business_id =
        dynamic_find_business_by_slug(root, business_slug).map(|row| row_i64(row, "id"))?;
    let mut output = String::new();
    for technician in state_rows(root, "technicians")
        .iter()
        .filter(|row| row_i64(row, "business_id") == business_id)
        .take(MAX_OUTPUT_ROWS)
    {
        let technician_id = row_i64(technician, "id");
        let availability_rows = state_rows(root, "technician_availability")
            .iter()
            .filter(|row| row_i64(row, "technician_id") == technician_id)
            .collect::<Vec<_>>();
        let mut availability = String::new();
        for row in &availability_rows {
            let availability_id = row_i64(row, "id");
            let day_of_week = value_text(row.get("day_of_week"));
            let start_time = value_text(row.get("start_time"));
            let end_time = value_text(row.get("end_time"));
            let day_select_html = render_technician_card_day_select(
                app_root,
                &format!("technician-entry-day-{availability_id}"),
                &day_of_week,
            )?;
            let start_input_html = render_technician_card_input(
                app_root,
                &format!("technician-entry-start-{availability_id}"),
                "start_time",
                "Start time",
                "time",
                "form-control form-control-compact availability-inline-input form-control-time",
                &start_time,
                " autocomplete=\"section-technician time\" aria-label=\"Start time\"",
            )?;
            let end_input_html = render_technician_card_input(
                app_root,
                &format!("technician-entry-end-{availability_id}"),
                "end_time",
                "End time",
                "time",
                "form-control form-control-compact availability-inline-input form-control-time",
                &end_time,
                " autocomplete=\"section-technician time\" aria-label=\"End time\"",
            )?;
            let save_button_html = render_technician_card_button(
                app_root,
                "technician_availability_save_button",
                "button",
                "btn btn-success btn-icon btn-icon-sm business-admin-save-button",
                &format!(
                    " title=\"Save Technician Availability\" aria-label=\"Save Technician Availability\" hx-post=\"/businesses/{business_slug}/technicians/{technician_id}/availability/{availability_id}/edit/\" hx-include=\"closest form\" hx-target=\"#business-technician-rows\" hx-swap=\"innerHTML\""
                ),
                "templates/shared/fragments/ui_content_save_technician_availability.html",
            )?;
            let delete_button_html = render_technician_card_button(
                app_root,
                "technician_availability_delete_button",
                "button",
                "btn btn-danger btn-icon btn-icon-sm",
                &format!(
                    " title=\"Delete Technician Availability\" aria-label=\"Delete Technician Availability\" hx-post=\"/businesses/{business_slug}/technicians/{technician_id}/availability/{availability_id}/delete/\" hx-include=\"closest form\" hx-target=\"#business-technician-rows\" hx-swap=\"innerHTML\""
                ),
                "templates/shared/fragments/ui_content_delete_technician_availability.html",
            )?;
            availability.push_str(&generated::render_generated_admin_fragment_from_value_runtime(
                app_root,
                "templates/businesses/fragments/business_admin_technician_availability_entry.html",
                &Map::from_iter([
                    (
                        "save_path".to_owned(),
                        Value::String(format!("/businesses/{business_slug}/technicians/{technician_id}/availability/{availability_id}/edit/")),
                    ),
                    (
                        "technician_availability_day_select_ui_html".to_owned(),
                        Value::String(day_select_html),
                    ),
                    (
                        "technician_availability_start_time_input_ui_html".to_owned(),
                        Value::String(start_input_html),
                    ),
                    (
                        "technician_availability_end_time_input_ui_html".to_owned(),
                        Value::String(end_input_html),
                    ),
                    (
                        "technician_availability_save_button_ui_html".to_owned(),
                        Value::String(save_button_html),
                    ),
                    (
                        "technician_availability_delete_button_ui_html".to_owned(),
                        Value::String(delete_button_html),
                    ),
                ]),
            )?);
        }
        let params = Map::from_iter([
            (
                "save_path".to_owned(),
                Value::String(format!(
                    "/businesses/{business_slug}/technicians/{technician_id}/edit/"
                )),
            ),
            (
                "delete_path".to_owned(),
                Value::String(format!(
                    "/businesses/{business_slug}/technicians/{technician_id}/delete/"
                )),
            ),
            (
                "availability_create_path".to_owned(),
                Value::String(format!(
                    "/businesses/{business_slug}/technicians/{technician_id}/availability/new/"
                )),
            ),
            (
                "technician_card_name_input_ui_html".to_owned(),
                Value::String(render_technician_card_input(
                    app_root,
                    &format!("technician-name-{technician_id}"),
                    "name",
                    "Name",
                    "text",
                    "form-control form-control-compact business-admin-technician-inline-input",
                    &value_text(technician.get("name")),
                    " required readonly autocomplete=\"name\"",
                )?),
            ),
            (
                "technician_card_email_input_ui_html".to_owned(),
                Value::String(render_technician_card_input(
                    app_root,
                    &format!("technician-email-{technician_id}"),
                    "email",
                    "Email",
                    "email",
                    "form-control form-control-compact business-admin-technician-inline-input",
                    &value_text(technician.get("email")),
                    " required readonly autocomplete=\"email\"",
                )?),
            ),
            (
                "technician_card_edit_button_ui_html".to_owned(),
                Value::String(render_technician_card_button(
                    app_root,
                    &format!("technician-edit-{technician_id}"),
                    "button",
                    "btn btn-primary btn-icon btn-icon-sm business-admin-technician-edit-button",
                    " data-technician-edit-toggle=\"true\"",
                    "templates/shared/fragments/ui_content_edit_technician.html",
                )?),
            ),
            (
                "technician_card_save_button_ui_html".to_owned(),
                Value::String(render_technician_card_button(
                    app_root,
                    &format!("technician-save-{technician_id}"),
                    "submit",
                    "btn btn-success btn-icon btn-icon-sm business-admin-save-button business-admin-technician-save-button",
                    " hidden",
                    "templates/shared/fragments/ui_content_save_technician.html",
                )?),
            ),
            (
                "technician_card_delete_button_ui_html".to_owned(),
                Value::String(render_technician_card_button(
                    app_root,
                    &format!("technician-delete-{technician_id}"),
                    "button",
                    "btn btn-danger btn-icon btn-icon-sm business-admin-technician-delete-button",
                    &format!(
                        " hidden hx-post=\"/businesses/{business_slug}/technicians/{technician_id}/delete/\" hx-include=\"closest form\" hx-target=\"#business-technician-rows\" hx-swap=\"innerHTML\""
                    ),
                    "templates/shared/fragments/ui_content_delete_technician.html",
                )?),
            ),
            (
                "technician_card_availability_day_select_ui_html".to_owned(),
                Value::String(render_technician_card_day_select(
                    app_root,
                    &format!("technician-create-day-{technician_id}"),
                    "Mon",
                )?),
            ),
            (
                "technician_card_availability_start_time_input_ui_html".to_owned(),
                Value::String(render_technician_card_input(
                    app_root,
                    &format!("technician-create-start-{technician_id}"),
                    "start_time",
                    "Start time",
                    "time",
                    "form-control form-control-compact availability-inline-input form-control-time",
                    "09:00",
                    " autocomplete=\"section-technician time\" aria-label=\"Start time\"",
                )?),
            ),
            (
                "technician_card_availability_end_time_input_ui_html".to_owned(),
                Value::String(render_technician_card_input(
                    app_root,
                    &format!("technician-create-end-{technician_id}"),
                    "end_time",
                    "End time",
                    "time",
                    "form-control form-control-compact availability-inline-input form-control-time",
                    "17:00",
                    " autocomplete=\"section-technician time\" aria-label=\"End time\"",
                )?),
            ),
            (
                "technician_card_availability_add_button_ui_html".to_owned(),
                Value::String(render_technician_card_button(
                    app_root,
                    "technician_card_availability_add_button",
                    "button",
                    "btn btn-success btn-icon btn-icon-sm business-admin-save-button",
                    &format!(
                        " title=\"Add Technician Availability\" aria-label=\"Add Technician Availability\" hx-post=\"/businesses/{business_slug}/technicians/{technician_id}/availability/new/\" hx-include=\"closest form\" hx-target=\"#business-technician-rows\" hx-swap=\"innerHTML\""
                    ),
                    "templates/shared/fragments/ui_content_add_technician_availability.html",
                )?),
            ),
            (
                "technician_availability_summary_html".to_owned(),
                Value::String(if availability.is_empty() {
                    "No technician availability set.".to_owned()
                } else {
                    availability
                }),
            ),
            (
                "technician_name".to_owned(),
                Value::String(value_text(technician.get("name"))),
            ),
            (
                "technician_email".to_owned(),
                Value::String(value_text(technician.get("email"))),
            ),
        ]);
        output.push_str(
            &super::generated::render_generated_admin_fragment_from_value_runtime(
                app_root,
                "templates/businesses/fragments/business_admin_technician_card.html",
                &params,
            )?,
        );
    }
    Some(output)
}

/// Loads state and renders the business technician cards for an HTMX update.
///
/// # Parameters
///
/// - `state_path`: Input consumed by [`crate::runtime::business::dynamic_business_admin_technician_rows_html`].
/// - `business_slug`: Input consumed by [`crate::runtime::business::dynamic_business_admin_technician_rows_html`].
/// - `app_root`: Input consumed by [`crate::runtime::business::dynamic_business_admin_technician_rows_html`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::dynamic_business_admin_technician_rows_html`] can produce a value and [`None`] otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::dynamic_business_admin_technician_rows_html`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dynamic_business_admin_technician_rows_html(todo!(), "demo", std::path::Path::new("apps/dev_docs"));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dynamic_business_admin_technician_rows_html(
    state_path: &Path,
    business_slug: &str,
    app_root: &Path,
) -> Option<String> {
    if state_path.as_os_str().is_empty()
        || business_slug.is_empty()
        || app_root.as_os_str().is_empty()
    {
        return None;
    }
    let root = serde_json::from_str::<Value>(&fs::read_to_string(state_path).ok()?).ok()?;
    dynamic_business_admin_technician_rows_html_from_root(&root, business_slug, app_root)
}

#[derive(Debug, Clone, Default, Eq, PartialEq)]
/// Describes the selected SMTP relay without retaining a password value.
///
/// # Fields
///
/// - `relay_name`: Stored field on `EmailConfig`.
/// - `enabled`: Stored field on `EmailConfig`.
/// - `from_address`: Stored field on `EmailConfig`.
/// - `smtp_server`: Stored field on `EmailConfig`.
/// - `port`: Stored field on `EmailConfig`.
/// - `login`: Stored field on `EmailConfig`.
/// - `pass_env`: Stored field on `EmailConfig`.
/// - `encryption`: Stored field on `EmailConfig`.
/// - `timeout_seconds`: Stored field on `EmailConfig`.
/// - `max_message_bytes`: Stored field on `EmailConfig`.
///
/// # Examples
///
/// ```rust,ignore
/// let _ = std::mem::size_of::<pharos_native::runtime::business::EmailConfig>();
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for constructors, helpers, and neighboring runtime types.
pub struct EmailConfig {
    pub relay_name: String,
    pub enabled: bool,
    pub from_address: Option<String>,
    pub smtp_server: Option<String>,
    pub port: u16,
    pub login: Option<String>,
    pub pass_env: Option<String>,
    pub encryption: String,
    pub timeout_seconds: u64,
    pub max_message_bytes: usize,
}

#[derive(Debug, Clone, Default, Eq, PartialEq)]
/// Describes one outbound email request.
///
/// # Fields
///
/// - `from_address`: Stored field on `EmailMessage`.
/// - `to_address`: Stored field on `EmailMessage`.
/// - `subject`: Stored field on `EmailMessage`.
/// - `text_body`: Stored field on `EmailMessage`.
///
/// # Examples
///
/// ```rust,ignore
/// let _ = std::mem::size_of::<pharos_native::runtime::business::EmailMessage>();
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for constructors, helpers, and neighboring runtime types.
pub struct EmailMessage {
    pub from_address: Option<String>,
    pub to_address: String,
    pub subject: String,
    pub text_body: String,
}

#[derive(Debug, Clone, Default, Eq, PartialEq)]
/// Captures bounded email delivery state without exposing credentials.
///
/// # Fields
///
/// - `attempted`: Stored field on `EmailResult`.
/// - `delivered`: Stored field on `EmailResult`.
/// - `skipped`: Stored field on `EmailResult`.
/// - `retryable`: Stored field on `EmailResult`.
/// - `smtp_code`: Stored field on `EmailResult`.
/// - `error_message`: Stored field on `EmailResult`.
///
/// # Examples
///
/// ```rust,ignore
/// let _ = std::mem::size_of::<pharos_native::runtime::business::EmailResult>();
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for constructors, helpers, and neighboring runtime types.
pub struct EmailResult {
    pub attempted: bool,
    pub delivered: bool,
    pub skipped: bool,
    pub retryable: bool,
    pub smtp_code: i64,
    pub error_message: Option<String>,
}

/// Performs email config value.
fn email_config_value(
    app_root: &Path,
    runtime_conf_path: Option<&Path>,
    prefix: &str,
    suffix: &str,
) -> Option<String> {
    if suffix.is_empty() {
        return None;
    }
    super::cache::dynamic_config_allowlist_value(
        app_root,
        runtime_conf_path,
        &format!("{prefix}{suffix}"),
    )
}

/// Reports whether the native SMTP capability can be initialized.
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::email_curl_ready`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_curl_ready();
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_curl_ready() -> bool {
    cfg!(not(target_os = "wasi"))
}

/// Replaces the previous email error while retaining only owned text.
///
/// # Parameters
///
/// - `result`: Input consumed by [`crate::runtime::business::email_set_error`].
/// - `message`: Input consumed by [`crate::runtime::business::email_set_error`].
///
/// # Returns
///
/// Returns after [`crate::runtime::business::email_set_error`] applies its in-place effect.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_set_error(todo!(), "example");
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_set_error(result: &mut EmailResult, message: Option<&str>) {
    result.error_message = Some(message.unwrap_or_default().to_owned());
}

/// Parses a strict decimal integer or returns the supplied default.
///
/// # Parameters
///
/// - `value`: Input consumed by [`crate::runtime::business::email_parse_long_default`].
/// - `default_value`: Input consumed by [`crate::runtime::business::email_parse_long_default`].
///
/// # Returns
///
/// Returns the computed value produced by [`crate::runtime::business::email_parse_long_default`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_parse_long_default("value", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_parse_long_default(value: Option<&str>, default_value: i64) -> i64 {
    value
        .filter(|text| !text.is_empty())
        .and_then(|text| text.parse::<i64>().ok())
        .unwrap_or(default_value)
}

/// Returns whether a relay configuration explicitly enables outbound email.
///
/// # Parameters
///
/// - `app_root`: Input consumed by [`crate::runtime::business::email_enabled_from_config`].
/// - `runtime_conf_path`: Input consumed by [`crate::runtime::business::email_enabled_from_config`].
/// - `relay_prefix`: Input consumed by [`crate::runtime::business::email_enabled_from_config`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::email_enabled_from_config`] holds and `false` otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::email_enabled_from_config`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_enabled_from_config(std::path::Path::new("apps/dev_docs"), todo!(), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_enabled_from_config(
    app_root: &Path,
    runtime_conf_path: Option<&Path>,
    relay_prefix: &str,
) -> bool {
    if let Some(value) =
        super::cache::dynamic_config_allowlist_value(app_root, runtime_conf_path, "email")
    {
        return matches!(value.as_str(), "enabled" | "true" | "on" | "1");
    }
    ["server", "login", "pass", "mail_from"]
        .iter()
        .any(|suffix| {
            email_config_value(app_root, runtime_conf_path, relay_prefix, suffix)
                .is_some_and(|value| !value.is_empty())
        })
}

/// Validates an SMTP port against the selected encryption mode.
///
/// # Parameters
///
/// - `port`: Input consumed by [`crate::runtime::business::email_port_matches_encryption`].
/// - `encryption`: Input consumed by [`crate::runtime::business::email_port_matches_encryption`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::email_port_matches_encryption`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_port_matches_encryption("8080", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_port_matches_encryption(port: u16, encryption: &str) -> bool {
    matches!((port, encryption), (587, "STARTTLS") | (465, "SSL"))
}

/// Returns whether an SMTP response code is safe to retry.
///
/// # Parameters
///
/// - `response_code`: Input consumed by [`crate::runtime::business::email_smtp_response_retryable`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::email_smtp_response_retryable`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_smtp_response_retryable(todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_smtp_response_retryable(response_code: i64) -> bool {
    (400..500).contains(&response_code)
}

/// Returns whether a transport status represents a transient failure.
///
/// # Parameters
///
/// - `code`: Input consumed by [`crate::runtime::business::email_transport_code_retryable`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::email_transport_code_retryable`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_transport_code_retryable(todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_transport_code_retryable(code: i64) -> bool {
    matches!(code, 7 | 28 | 35 | 55 | 56 | 67)
}

/// Wraps a validated address for SMTP envelope use.
///
/// # Parameters
///
/// - `address`: Input consumed by [`crate::runtime::business::email_envelope_address_dup`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::email_envelope_address_dup`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_envelope_address_dup(todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_envelope_address_dup(address: &str) -> Option<String> {
    if !is_plausible_email_address(address) {
        return None;
    }
    Some(format!("<{address}>"))
}

/// Performs email body crlf.
fn email_body_crlf(text: &str) -> String {
    let mut output = String::with_capacity(text.len());
    let bytes = text.as_bytes();
    for (index, byte) in bytes.iter().enumerate() {
        if *byte == b'\n' && (index == 0 || bytes[index - 1] != b'\r') {
            output.push('\r');
        }
        output.push(*byte as char);
    }
    output
}

/// Returns whether plausible email address.
fn is_plausible_email_address(value: &str) -> bool {
    if value.is_empty() || value.contains(['\r', '\n']) {
        return false;
    }
    let Some((local, domain)) = value.split_once('@') else {
        return false;
    };
    !local.is_empty() && !domain.is_empty() && !domain.contains('@')
}

/// Builds a bounded RFC 822 payload for diagnostics and transport adapters.
///
/// # Parameters
///
/// - `message`: Input consumed by [`crate::runtime::business::email_rfc822_payload`].
/// - `max_message_bytes`: Input consumed by [`crate::runtime::business::email_rfc822_payload`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::email_rfc822_payload`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_rfc822_payload("example", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_rfc822_payload(message: &EmailMessage, max_message_bytes: usize) -> Option<String> {
    let from = message.from_address.as_deref()?;
    if !is_plausible_email_address(from)
        || !is_plausible_email_address(&message.to_address)
        || message.subject.contains(['\r', '\n'])
    {
        return None;
    }
    let body = email_body_crlf(&message.text_body);
    let payload = format!(
        "From: {from}\r\nTo: {}\r\nSubject: {}\r\nMIME-Version: 1.0\r\nContent-Type: text/plain; charset=UTF-8\r\nContent-Transfer-Encoding: 8bit\r\n\r\n{body}\r\n",
        message.to_address, message.subject
    );
    (payload.len() <= max_message_bytes).then_some(payload)
}

/// Performs email read payload.
///
/// # Parameters
///
/// - `message`: Input consumed by [`crate::runtime::business::email_read_payload`].
/// - `max_message_bytes`: Input consumed by [`crate::runtime::business::email_read_payload`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::email_read_payload`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_read_payload("example", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_read_payload(message: &EmailMessage, max_message_bytes: usize) -> Option<String> {
    email_rfc822_payload(message, max_message_bytes)
}

/// Loads one relay using app-over-runtime configuration precedence.
///
/// # Parameters
///
/// - `app_root`: Input consumed by [`crate::runtime::business::email_load_relay_config`].
/// - `runtime_conf_path`: Input consumed by [`crate::runtime::business::email_load_relay_config`].
/// - `relay_key_prefix`: Input consumed by [`crate::runtime::business::email_load_relay_config`].
///
/// # Returns
///
/// Returns the successful value produced by [`crate::runtime::business::email_load_relay_config`] or an error when the operation fails.
///
/// # Errors
///
/// Returns an error value when [`crate::runtime::business::email_load_relay_config`] cannot complete successfully.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_load_relay_config(std::path::Path::new("apps/dev_docs"), todo!(), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_load_relay_config(
    app_root: &Path,
    runtime_conf_path: Option<&Path>,
    relay_key_prefix: Option<&str>,
) -> Result<EmailConfig, &'static str> {
    if app_root.as_os_str().is_empty() {
        return Err("app root is required");
    }
    let prefix = relay_key_prefix
        .filter(|value| !value.is_empty())
        .unwrap_or("smtp_");
    let encryption = email_config_value(app_root, runtime_conf_path, prefix, "encryption")
        .unwrap_or_else(|| "STARTTLS".to_owned());
    let port_text = email_config_value(app_root, runtime_conf_path, prefix, "port");
    let port = email_parse_long_default(
        port_text.as_deref(),
        if encryption == "SSL" { 465 } else { 587 },
    );
    let timeout_seconds = email_parse_long_default(
        email_config_value(app_root, runtime_conf_path, prefix, "timeout_seconds").as_deref(),
        10,
    );
    let max_message_bytes = email_parse_long_default(
        email_config_value(app_root, runtime_conf_path, prefix, "max_message_bytes").as_deref(),
        1_048_576,
    );
    if !(encryption == "STARTTLS" || encryption == "SSL")
        || port <= 0
        || timeout_seconds <= 0
        || max_message_bytes <= 0
        || (port_text.is_some() && !email_port_matches_encryption(port as u16, &encryption))
    {
        return Err("invalid SMTP configuration");
    }
    let config = EmailConfig {
        relay_name: if prefix == "smtp2_" {
            "secondary"
        } else {
            "primary"
        }
        .to_owned(),
        enabled: email_enabled_from_config(app_root, runtime_conf_path, prefix),
        from_address: email_config_value(app_root, runtime_conf_path, prefix, "mail_from"),
        smtp_server: email_config_value(app_root, runtime_conf_path, prefix, "server"),
        port: u16::try_from(port).map_err(|_| "invalid SMTP port")?,
        login: email_config_value(app_root, runtime_conf_path, prefix, "login"),
        pass_env: email_config_value(app_root, runtime_conf_path, prefix, "pass"),
        encryption,
        timeout_seconds: u64::try_from(timeout_seconds).map_err(|_| "invalid timeout")?,
        max_message_bytes: usize::try_from(max_message_bytes)
            .map_err(|_| "invalid message limit")?,
    };
    if config.enabled && (config.from_address.is_none() || config.encryption.is_empty()) {
        return Err("enabled SMTP configuration is incomplete");
    }
    Ok(config)
}

/// Clears all owned relay fields while retaining no secret material.
///
/// # Parameters
///
/// - `config`: Input consumed by [`crate::runtime::business::email_free_config`].
///
/// # Returns
///
/// Returns after [`crate::runtime::business::email_free_config`] applies its in-place effect.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_free_config(todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_free_config(config: &mut EmailConfig) {
    *config = EmailConfig::default();
}

/// Clears one delivery result.
///
/// # Parameters
///
/// - `result`: Input consumed by [`crate::runtime::business::email_free_result`].
///
/// # Returns
///
/// Returns after [`crate::runtime::business::email_free_result`] applies its in-place effect.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_free_result(todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_free_result(result: &mut EmailResult) {
    *result = EmailResult::default();
}

/// Sends one text message through lettre on native targets.
///
/// # Parameters
///
/// - `config`: Input consumed by [`crate::runtime::business::email_send_text`].
/// - `message`: Input consumed by [`crate::runtime::business::email_send_text`].
/// - `result`: Input consumed by [`crate::runtime::business::email_send_text`].
///
/// # Returns
///
/// Returns the computed value produced by [`crate::runtime::business::email_send_text`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_send_text(todo!(), "example", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_send_text(
    config: &EmailConfig,
    message: &EmailMessage,
    result: &mut EmailResult,
) -> i32 {
    email_free_result(result);
    if !config.enabled {
        result.skipped = true;
        email_set_error(result, Some("email disabled"));
        return 0;
    }
    let Some(server) = config
        .smtp_server
        .as_deref()
        .filter(|value| !value.is_empty())
    else {
        result.skipped = true;
        email_set_error(result, Some("smtp configuration incomplete"));
        return 0;
    };
    let Some(login) = config.login.as_deref().filter(|value| !value.is_empty()) else {
        result.skipped = true;
        email_set_error(result, Some("smtp configuration incomplete"));
        return 0;
    };
    let Some(password_name) = config.pass_env.as_deref().filter(|value| !value.is_empty()) else {
        result.skipped = true;
        email_set_error(result, Some("smtp password is not configured"));
        return 0;
    };
    let Some(password) = env::var(password_name)
        .ok()
        .filter(|value| !value.is_empty())
    else {
        result.skipped = true;
        email_set_error(result, Some("smtp password is not configured"));
        return 0;
    };
    let Some(from) = message
        .from_address
        .as_deref()
        .or(config.from_address.as_deref())
    else {
        result.skipped = true;
        email_set_error(result, Some("sender address is not configured"));
        return 0;
    };
    if !is_plausible_email_address(from) || !is_plausible_email_address(&message.to_address) {
        result.skipped = true;
        email_set_error(result, Some("invalid outbound email message"));
        return 0;
    }
    #[cfg(any(not(feature = "smtp"), target_os = "wasi"))]
    {
        let _ = (server, login, password, message);
        result.skipped = true;
        email_set_error(result, Some("SMTP support is unavailable"));
        69
    }
    #[cfg(all(feature = "smtp", not(target_os = "wasi")))]
    {
        let outcome = pharos_runtime_integrations::smtp::send_text(
            pharos_runtime_integrations::smtp::SmtpRequest {
                server,
                port: config.port,
                login,
                password: &password,
                from,
                to: &message.to_address,
                subject: &message.subject,
                text_body: &message.text_body,
                timeout_seconds: config.timeout_seconds,
            },
        );
        result.attempted = true;
        result.delivered = outcome.delivered;
        result.retryable = outcome.retryable;
        result.smtp_code = outcome.smtp_code;
        if let Some(error) = outcome.error.as_deref() {
            email_set_error(result, Some(error));
        }
        if outcome.delivered { 0 } else { 69 }
    }
}

/// Performs notification template path.
fn notification_template_path(app: &AppRuntime, template_id: &str) -> Option<std::path::PathBuf> {
    if template_id.is_empty() || template_id.contains('/') || template_id.contains("..") {
        return None;
    }
    let candidate_paths = [
        app.app_root.as_deref().map(Path::new).map(|root| {
            root.join("templates/email")
                .join(format!("{template_id}.yml"))
        }),
        app.app_root.as_deref().map(Path::new).map(|root| {
            root.join("templates/email")
                .join(format!("{template_id}.json"))
        }),
        app.artifact_dir.as_deref().map(Path::new).map(|root| {
            root.join("templates/email")
                .join(format!("{template_id}.yml"))
        }),
        app.artifact_dir.as_deref().map(Path::new).map(|root| {
            root.join("templates/email")
                .join(format!("{template_id}.json"))
        }),
    ];
    candidate_paths
        .into_iter()
        .flatten()
        .find(|path| path.is_file())
}

/// Performs notification template string.
fn notification_template_string(value: Option<&Value>) -> String {
    match value {
        Some(Value::String(text)) => text.clone(),
        Some(Value::Number(number)) => number.to_string(),
        Some(Value::Bool(flag)) => flag.to_string(),
        Some(Value::Null) | None => String::new(),
        Some(other) => serde_json::to_string(other).unwrap_or_default(),
    }
}

/// Renders notification template text.
fn render_notification_template_text(
    template_text: &str,
    params: &Map<String, Value>,
) -> Option<String> {
    if template_text.len() > 256 * 1024 {
        return None;
    }
    let mut out = String::with_capacity(template_text.len());
    let mut cursor = 0usize;
    while let Some(relative_open) = template_text[cursor..].find("{{") {
        let open = cursor + relative_open;
        out.push_str(&template_text[cursor..open]);
        let key_start = open + 2;
        let relative_close = template_text[key_start..].find("}}")?;
        let close = key_start + relative_close;
        let key = template_text[key_start..close].trim();
        if !key.is_empty() {
            out.push_str(&notification_template_string(params.get(key)));
        }
        cursor = close + 2;
    }
    out.push_str(&template_text[cursor..]);
    Some(out)
}

/// Loads one app-owned email template and renders it into a bounded outbound message.
///
/// # Parameters
///
/// - `app`: Input consumed by [`crate::runtime::business::load_notification_email_message`].
/// - `recipient`: Input consumed by [`crate::runtime::business::load_notification_email_message`].
/// - `template_id`: Input consumed by [`crate::runtime::business::load_notification_email_message`].
/// - `params_root`: Input consumed by [`crate::runtime::business::load_notification_email_message`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::load_notification_email_message`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::load_notification_email_message(todo!(), todo!(), todo!(), &serde_json::json!({}));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn load_notification_email_message(
    app: &AppRuntime,
    recipient: &str,
    template_id: &str,
    params_root: &Value,
) -> Option<EmailMessage> {
    if recipient.is_empty() || template_id.is_empty() || !params_root.is_object() {
        return None;
    }
    let template_path = notification_template_path(app, template_id)?;
    let template = if template_path.extension().and_then(|ext| ext.to_str()) == Some("json") {
        super::json_commands::json_doc_load_file(&template_path)?
    } else {
        parse_yaml_file(&template_path)?
    };
    let params = params_root.as_object()?;
    let subject = render_notification_template_text(
        template
            .get("subject")
            .and_then(Value::as_str)
            .unwrap_or_default(),
        params,
    )?;
    let text_body = render_notification_template_text(
        template
            .get("body")
            .and_then(Value::as_str)
            .unwrap_or_default(),
        params,
    )?;
    if subject.is_empty() || subject.contains(['\r', '\n']) {
        return None;
    }
    Some(EmailMessage {
        from_address: None,
        to_address: recipient.to_owned(),
        subject,
        text_body,
    })
}

/// Applies the bounded runtime contract for `free_finalize_fields`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::free_finalize_fields`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::free_finalize_fields`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::free_finalize_fields(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn free_finalize_fields(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `clone_or_empty_finalize`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::clone_or_empty_finalize`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::clone_or_empty_finalize`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::clone_or_empty_finalize(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn clone_or_empty_finalize(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `count_substring_occurrences`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::count_substring_occurrences`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::count_substring_occurrences`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::count_substring_occurrences(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn count_substring_occurrences(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `build_app_index_html`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::build_app_index_html`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::build_app_index_html`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::build_app_index_html(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn build_app_index_html(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `build_artifact_local_app_manifest_json`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::build_artifact_local_app_manifest_json`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::build_artifact_local_app_manifest_json`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::build_artifact_local_app_manifest_json(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn build_artifact_local_app_manifest_json(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `build_app_build_report_json`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::build_app_build_report_json`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::build_app_build_report_json`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::build_app_build_report_json(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn build_app_build_report_json(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `connection_recv`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::connection_recv`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::connection_recv`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::connection_recv(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn connection_recv(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `dispatch_route_pattern_matches`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::dispatch_route_pattern_matches`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::dispatch_route_pattern_matches`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dispatch_route_pattern_matches(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dispatch_route_pattern_matches(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `docs_render_build_site_from_manifest`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::docs_render_build_site_from_manifest`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::docs_render_build_site_from_manifest`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::docs_render_build_site_from_manifest(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn docs_render_build_site_from_manifest(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `dynamic_technician_booked_for_slot`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::dynamic_technician_booked_for_slot`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::dynamic_technician_booked_for_slot`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dynamic_technician_booked_for_slot(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dynamic_technician_booked_for_slot(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `write_json_error_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::write_json_error_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::write_json_error_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::write_json_error_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn write_json_error_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `now_iso_utc_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::now_iso_utc_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::now_iso_utc_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::now_iso_utc_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn now_iso_utc_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `find_action_contract_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::find_action_contract_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::find_action_contract_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::find_action_contract_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn find_action_contract_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `action_contract_is_declarative_executable_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::action_contract_is_declarative_executable_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::action_contract_is_declarative_executable_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::action_contract_is_declarative_executable_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn action_contract_is_declarative_executable_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `find_workflow_transition_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::find_workflow_transition_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::find_workflow_transition_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::find_workflow_transition_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn find_workflow_transition_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `parse_ymd_business_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::parse_ymd_business_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::parse_ymd_business_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::parse_ymd_business_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn parse_ymd_business_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `free_action_execution_context_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::free_action_execution_context_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::free_action_execution_context_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::free_action_execution_context_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn free_action_execution_context_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `presentation_field_string`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::presentation_field_string`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::presentation_field_string`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::presentation_field_string(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn presentation_field_string(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `load_action_inputs_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::load_action_inputs_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::load_action_inputs_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::load_action_inputs_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn load_action_inputs_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `append_record_primitive_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::append_record_primitive_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_record_primitive_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_record_primitive_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_record_primitive_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `append_records_from_input_list_primitive_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::append_records_from_input_list_primitive_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_records_from_input_list_primitive_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_records_from_input_list_primitive_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_records_from_input_list_primitive_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `append_records_from_related_collection_primitive_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::append_records_from_related_collection_primitive_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_records_from_related_collection_primitive_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_records_from_related_collection_primitive_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_records_from_related_collection_primitive_logic_local(
    root: &mut serde_json::Value,
) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `update_record_primitive_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::update_record_primitive_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::update_record_primitive_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::update_record_primitive_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn update_record_primitive_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `scoped_reassignment_primitive_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::scoped_reassignment_primitive_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::scoped_reassignment_primitive_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::scoped_reassignment_primitive_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn scoped_reassignment_primitive_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `bulk_update_primitive_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::bulk_update_primitive_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::bulk_update_primitive_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::bulk_update_primitive_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn bulk_update_primitive_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `set_root_fields_primitive_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::set_root_fields_primitive_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::set_root_fields_primitive_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::set_root_fields_primitive_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn set_root_fields_primitive_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `process_due_integration_deliveries_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::process_due_integration_deliveries_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::process_due_integration_deliveries_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::process_due_integration_deliveries_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn process_due_integration_deliveries_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `append_job_workflow_event_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::append_job_workflow_event_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_job_workflow_event_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_job_workflow_event_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_job_workflow_event_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `append_action_report_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::append_action_report_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_action_report_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_action_report_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_action_report_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `append_workflow_and_effects_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::append_workflow_and_effects_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_workflow_and_effects_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_workflow_and_effects_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_workflow_and_effects_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `append_audit_event_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::append_audit_event_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_audit_event_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_audit_event_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_audit_event_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `persist_mut_doc_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::persist_mut_doc_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::persist_mut_doc_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::persist_mut_doc_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn persist_mut_doc_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `send_action_response_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::send_action_response_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::send_action_response_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::send_action_response_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn send_action_response_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `construct_packaged_route_fixture_path`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::construct_packaged_route_fixture_path`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::construct_packaged_route_fixture_path`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::construct_packaged_route_fixture_path(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn construct_packaged_route_fixture_path(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `construct_direct_route_fixture_path`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::construct_direct_route_fixture_path`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::construct_direct_route_fixture_path`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::construct_direct_route_fixture_path(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn construct_direct_route_fixture_path(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `dynamic_media_resolve_path`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::dynamic_media_resolve_path`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::dynamic_media_resolve_path`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dynamic_media_resolve_path(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dynamic_media_resolve_path(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `invite_accept_path`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::invite_accept_path`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::invite_accept_path`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::invite_accept_path(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn invite_accept_path(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `password_reset_completion_path`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::password_reset_completion_path`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::password_reset_completion_path`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::password_reset_completion_path(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn password_reset_completion_path(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `append_notification_delivery`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::append_notification_delivery`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_notification_delivery`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_notification_delivery(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_notification_delivery(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `send_templated_email_notification`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::send_templated_email_notification`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::send_templated_email_notification`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::send_templated_email_notification(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn send_templated_email_notification(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `csrf_request_token`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::csrf_request_token`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::csrf_request_token`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::csrf_request_token(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn csrf_request_token(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `runtime_fixture_path`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::runtime_fixture_path`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::runtime_fixture_path`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::runtime_fixture_path(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn runtime_fixture_path(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `time_text_to_minutes`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::time_text_to_minutes`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::time_text_to_minutes`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::time_text_to_minutes(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn time_text_to_minutes(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `generated_surface_route_pattern`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::generated_surface_route_pattern`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::generated_surface_route_pattern`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::generated_surface_route_pattern(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn generated_surface_route_pattern(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `generated_surface_tenant_scope`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::generated_surface_tenant_scope`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::generated_surface_tenant_scope`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::generated_surface_tenant_scope(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn generated_surface_tenant_scope(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `generated_surface_field_label`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::generated_surface_field_label`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::generated_surface_field_label`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::generated_surface_field_label(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn generated_surface_field_label(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `generated_surface_filter_item_matches`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::generated_surface_filter_item_matches`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::generated_surface_filter_item_matches`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::generated_surface_filter_item_matches(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn generated_surface_filter_item_matches(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `generated_surface_compare_items`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::generated_surface_compare_items`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::generated_surface_compare_items`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::generated_surface_compare_items(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn generated_surface_compare_items(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `account_created_page_params_json`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::account_created_page_params_json`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::account_created_page_params_json`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::account_created_page_params_json(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn account_created_page_params_json(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `password_reset_sent_page_params_json`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::password_reset_sent_page_params_json`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::password_reset_sent_page_params_json`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::password_reset_sent_page_params_json(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn password_reset_sent_page_params_json(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `secure_text_equals`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::secure_text_equals`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::secure_text_equals`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::secure_text_equals(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn secure_text_equals(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `find_user_by_username_runtime_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::find_user_by_username_runtime_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::find_user_by_username_runtime_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::find_user_by_username_runtime_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn find_user_by_username_runtime_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `find_user_by_email_runtime_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::find_user_by_email_runtime_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::find_user_by_email_runtime_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::find_user_by_email_runtime_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn find_user_by_email_runtime_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `find_user_by_id_runtime_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::find_user_by_id_runtime_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::find_user_by_id_runtime_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::find_user_by_id_runtime_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn find_user_by_id_runtime_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `issue_browser_session`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::issue_browser_session`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::issue_browser_session`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::issue_browser_session(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn issue_browser_session(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `json_extract_array_in_section`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::json_extract_array_in_section`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::json_extract_array_in_section`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::json_extract_array_in_section(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn json_extract_array_in_section(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `ensure_artifact_start_script_executable`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::ensure_artifact_start_script_executable`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::ensure_artifact_start_script_executable`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::ensure_artifact_start_script_executable(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn ensure_artifact_start_script_executable(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `artifact_dir_overlaps_app_root`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::artifact_dir_overlaps_app_root`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::artifact_dir_overlaps_app_root`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::artifact_dir_overlaps_app_root(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn artifact_dir_overlaps_app_root(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `free_loaded_app_runtime_fields`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::free_loaded_app_runtime_fields`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::free_loaded_app_runtime_fields`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::free_loaded_app_runtime_fields(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn free_loaded_app_runtime_fields(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `rewrite_html_md_links`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::rewrite_html_md_links`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::rewrite_html_md_links`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::rewrite_html_md_links(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn rewrite_html_md_links(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `docs_remove_declared_paths_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::docs_remove_declared_paths_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::docs_remove_declared_paths_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::docs_remove_declared_paths_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn docs_remove_declared_paths_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `availability_day_valid_booking_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::availability_day_valid_booking_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::availability_day_valid_booking_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::availability_day_valid_booking_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn availability_day_valid_booking_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `business_slug_for_technician_booking_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::business_slug_for_technician_booking_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::business_slug_for_technician_booking_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::business_slug_for_technician_booking_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn business_slug_for_technician_booking_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `integration_adapter_target_url_dup_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::integration_adapter_target_url_dup_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::integration_adapter_target_url_dup_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::integration_adapter_target_url_dup_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn integration_adapter_target_url_dup_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `integration_adapter_signature_field_dup_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::integration_adapter_signature_field_dup_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::integration_adapter_signature_field_dup_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::integration_adapter_signature_field_dup_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn integration_adapter_signature_field_dup_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `request_form_value_dup_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::request_form_value_dup_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::request_form_value_dup_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::request_form_value_dup_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn request_form_value_dup_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `load_contract_doc_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::load_contract_doc_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::load_contract_doc_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::load_contract_doc_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn load_contract_doc_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `time_ranges_overlap_business_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::time_ranges_overlap_business_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::time_ranges_overlap_business_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::time_ranges_overlap_business_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn time_ranges_overlap_business_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `note_created_record_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::note_created_record_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::note_created_record_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::note_created_record_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn note_created_record_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `note_updated_record_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::note_updated_record_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::note_updated_record_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::note_updated_record_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn note_updated_record_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `note_bounded_scope_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::note_bounded_scope_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::note_bounded_scope_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::note_bounded_scope_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn note_bounded_scope_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `free_input_field_map_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::free_input_field_map_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::free_input_field_map_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::free_input_field_map_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn free_input_field_map_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `field_value_from_contract_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::field_value_from_contract_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::field_value_from_contract_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::field_value_from_contract_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn field_value_from_contract_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `split_trimmed_input_list`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::split_trimmed_input_list`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::split_trimmed_input_list`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::split_trimmed_input_list(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn split_trimmed_input_list(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `scoped_resource_id_dup_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::scoped_resource_id_dup_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::scoped_resource_id_dup_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::scoped_resource_id_dup_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn scoped_resource_id_dup_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `record_field_matches_text_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::record_field_matches_text_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::record_field_matches_text_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::record_field_matches_text_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn record_field_matches_text_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `scope_match_expected_text_dup_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::scope_match_expected_text_dup_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::scope_match_expected_text_dup_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::scope_match_expected_text_dup_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn scope_match_expected_text_dup_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `matching_record_count_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::matching_record_count_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::matching_record_count_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::matching_record_count_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn matching_record_count_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `find_mut_record_by_long_field_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::find_mut_record_by_long_field_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::find_mut_record_by_long_field_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::find_mut_record_by_long_field_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn find_mut_record_by_long_field_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `find_mut_record_by_id_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::find_mut_record_by_id_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::find_mut_record_by_id_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::find_mut_record_by_id_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn find_mut_record_by_id_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `effect_payload_json_dup_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::effect_payload_json_dup_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::effect_payload_json_dup_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::effect_payload_json_dup_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn effect_payload_json_dup_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `append_job_attempt_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::append_job_attempt_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_job_attempt_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_job_attempt_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_job_attempt_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `append_enqueued_job_row_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::append_enqueued_job_row_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_enqueued_job_row_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_enqueued_job_row_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_enqueued_job_row_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `send_redirect_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::send_redirect_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::send_redirect_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::send_redirect_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn send_redirect_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `send_json_action_result_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::send_json_action_result_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::send_json_action_result_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::send_json_action_result_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn send_json_action_result_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `redirect_business_dashboard_management_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::redirect_business_dashboard_management_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::redirect_business_dashboard_management_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::redirect_business_dashboard_management_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn redirect_business_dashboard_management_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `absolute_public_url_for_path`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::absolute_public_url_for_path`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::absolute_public_url_for_path`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::absolute_public_url_for_path(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn absolute_public_url_for_path(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `render_no_email_access_link_html`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::render_no_email_access_link_html`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::render_no_email_access_link_html`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::render_no_email_access_link_html(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn render_no_email_access_link_html(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `log_email_delivery_attempt`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::log_email_delivery_attempt`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::log_email_delivery_attempt`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::log_email_delivery_attempt(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn log_email_delivery_attempt(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `log_email_delivery_retry`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::log_email_delivery_retry`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::log_email_delivery_retry`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::log_email_delivery_retry(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn log_email_delivery_retry(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `pause_email_retry`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::pause_email_retry`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::pause_email_retry`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::pause_email_retry(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn pause_email_retry(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `record_email_delivery_outcome`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::record_email_delivery_outcome`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::record_email_delivery_outcome`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::record_email_delivery_outcome(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn record_email_delivery_outcome(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `digits_only_text_runtime_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::digits_only_text_runtime_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::digits_only_text_runtime_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::digits_only_text_runtime_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn digits_only_text_runtime_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `streq_casefold_runtime_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::streq_casefold_runtime_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::streq_casefold_runtime_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::streq_casefold_runtime_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn streq_casefold_runtime_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `contains_casefold_runtime_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::contains_casefold_runtime_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::contains_casefold_runtime_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::contains_casefold_runtime_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn contains_casefold_runtime_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `weekday_rank_runtime_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::weekday_rank_runtime_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::weekday_rank_runtime_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::weekday_rank_runtime_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn weekday_rank_runtime_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `pbkdf2_sha256`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::pbkdf2_sha256`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::pbkdf2_sha256`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::pbkdf2_sha256(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn pbkdf2_sha256(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `iso_after_seconds`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::iso_after_seconds`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::iso_after_seconds`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::iso_after_seconds(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn iso_after_seconds(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `copy_directory_recursive`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::copy_directory_recursive`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::copy_directory_recursive`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::copy_directory_recursive(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn copy_directory_recursive(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `docs_markdown_to_html_with_remap`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::docs_markdown_to_html_with_remap`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::docs_markdown_to_html_with_remap`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::docs_markdown_to_html_with_remap(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn docs_markdown_to_html_with_remap(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `append_file_to_buffer`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::append_file_to_buffer`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_file_to_buffer`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_file_to_buffer(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_file_to_buffer(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `append_path_marker`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::append_path_marker`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_path_marker`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_path_marker(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_path_marker(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `resolve_app_path`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::resolve_app_path`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::resolve_app_path`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::resolve_app_path(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn resolve_app_path(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `email_render_yaml_template`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::email_render_yaml_template`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::email_render_yaml_template`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_render_yaml_template(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_render_yaml_template(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `path_has_prefix_segment`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::path_has_prefix_segment`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::path_has_prefix_segment`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::path_has_prefix_segment(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn path_has_prefix_segment(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `reference_renderer_build_page`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::reference_renderer_build_page`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::reference_renderer_build_page`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::reference_renderer_build_page(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn reference_renderer_build_page(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `path_canonicalize`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::path_canonicalize`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::path_canonicalize`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::path_canonicalize(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn path_canonicalize(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `declarative_source_api_prefixed_path`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::declarative_source_api_prefixed_path`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::declarative_source_api_prefixed_path`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::declarative_source_api_prefixed_path(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn declarative_source_api_prefixed_path(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `declarative_source_build_field_types_mut`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::declarative_source_build_field_types_mut`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::declarative_source_build_field_types_mut`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::declarative_source_build_field_types_mut(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn declarative_source_build_field_types_mut(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `declarative_source_default_item_title_field`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::declarative_source_default_item_title_field`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::declarative_source_default_item_title_field`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::declarative_source_default_item_title_field(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn declarative_source_default_item_title_field(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `declarative_source_derived_field_constraints_mut`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::declarative_source_derived_field_constraints_mut`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::declarative_source_derived_field_constraints_mut`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::declarative_source_derived_field_constraints_mut(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn declarative_source_derived_field_constraints_mut(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `dbuf_put_tag_open_with_class`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::dbuf_put_tag_open_with_class`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::dbuf_put_tag_open_with_class`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dbuf_put_tag_open_with_class(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dbuf_put_tag_open_with_class(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `render_sidebar_item_template`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::render_sidebar_item_template`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::render_sidebar_item_template`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::render_sidebar_item_template(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn render_sidebar_item_template(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `docs_nav_append_entry_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::docs_nav_append_entry_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::docs_nav_append_entry_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::docs_nav_append_entry_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn docs_nav_append_entry_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `dynamic_generated_admin_back_path_template`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::dynamic_generated_admin_back_path_template`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::dynamic_generated_admin_back_path_template`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dynamic_generated_admin_back_path_template(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dynamic_generated_admin_back_path_template(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `request_body_bytes_dup_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::request_body_bytes_dup_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::request_body_bytes_dup_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::request_body_bytes_dup_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn request_body_bytes_dup_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `mut_object_string_dup_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::mut_object_string_dup_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::mut_object_string_dup_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::mut_object_string_dup_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn mut_object_string_dup_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `mut_object_long_default_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::mut_object_long_default_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::mut_object_long_default_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::mut_object_long_default_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn mut_object_long_default_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `free_outbound_http_result_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::free_outbound_http_result_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::free_outbound_http_result_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::free_outbound_http_result_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn free_outbound_http_result_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `now_plus_seconds_iso_utc_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::now_plus_seconds_iso_utc_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::now_plus_seconds_iso_utc_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::now_plus_seconds_iso_utc_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn now_plus_seconds_iso_utc_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `replace_owned_string_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::replace_owned_string_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::replace_owned_string_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::replace_owned_string_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn replace_owned_string_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `note_webhook_delivery_outcome_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::note_webhook_delivery_outcome_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::note_webhook_delivery_outcome_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::note_webhook_delivery_outcome_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn note_webhook_delivery_outcome_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `string_value_from_contract_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::string_value_from_contract_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::string_value_from_contract_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::string_value_from_contract_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn string_value_from_contract_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `set_mut_object_field_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::set_mut_object_field_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::set_mut_object_field_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::set_mut_object_field_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn set_mut_object_field_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `matching_record_count_value_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::matching_record_count_value_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::matching_record_count_value_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::matching_record_count_value_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn matching_record_count_value_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `next_section_id_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::next_section_id_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::next_section_id_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::next_section_id_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn next_section_id_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `ensure_mut_array_field_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::ensure_mut_array_field_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::ensure_mut_array_field_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::ensure_mut_array_field_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn ensure_mut_array_field_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `outbound_http_post_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::outbound_http_post_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::outbound_http_post_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::outbound_http_post_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn outbound_http_post_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `http_reason_phrase_logic_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::http_reason_phrase_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::http_reason_phrase_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::http_reason_phrase_logic_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn http_reason_phrase_logic_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `dynamic_render_business_admin_availability_rows_html`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::dynamic_render_business_admin_availability_rows_html`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::dynamic_render_business_admin_availability_rows_html`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dynamic_render_business_admin_availability_rows_html(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dynamic_render_business_admin_availability_rows_html(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `store_uploaded_media`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::store_uploaded_media`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::store_uploaded_media`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::store_uploaded_media(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn store_uploaded_media(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `persist_app_state_text_runtime_local`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::persist_app_state_text_runtime_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::persist_app_state_text_runtime_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::persist_app_state_text_runtime_local(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn persist_app_state_text_runtime_local(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `copy_file_binary`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::copy_file_binary`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::copy_file_binary`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::copy_file_binary(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn copy_file_binary(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `remove_directory_recursive`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::remove_directory_recursive`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::remove_directory_recursive`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::remove_directory_recursive(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn remove_directory_recursive(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `render_page_html`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::render_page_html`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::render_page_html`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::render_page_html(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn render_page_html(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `email_relay_name_dup_from_prefix`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::email_relay_name_dup_from_prefix`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::email_relay_name_dup_from_prefix`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_relay_name_dup_from_prefix(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_relay_name_dup_from_prefix(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `email_rfc822_payload_dup`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::email_rfc822_payload_dup`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::email_rfc822_payload_dup`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_rfc822_payload_dup(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_rfc822_payload_dup(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `email_template_path_dup`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::email_template_path_dup`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::email_template_path_dup`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_template_path_dup(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_template_path_dup(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `email_yaml_parse_text`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::email_yaml_parse_text`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::email_yaml_parse_text`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_yaml_parse_text(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_yaml_parse_text(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `email_render_text_with_vars`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::email_render_text_with_vars`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::email_render_text_with_vars`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::email_render_text_with_vars(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn email_render_text_with_vars(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

/// Applies the bounded runtime contract for `reference_yaml_doc_load`.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::reference_yaml_doc_load`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::reference_yaml_doc_load`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::reference_yaml_doc_load(std::path::Path::new("."));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn reference_yaml_doc_load(root: &mut serde_json::Value) -> bool {
    if !root.is_object() {
        *root = serde_json::Value::Object(serde_json::Map::new());
    }
    true
}

#[derive(Debug, Clone, Default, Eq, PartialEq)]
/// Public struct `ParsedHttpUrlLogicLocal` used by this module.
///
/// # Fields
///
/// - `scheme`: Stored field on `ParsedHttpUrlLogicLocal`.
/// - `host`: Stored field on `ParsedHttpUrlLogicLocal`.
/// - `port`: Stored field on `ParsedHttpUrlLogicLocal`.
/// - `path`: Stored field on `ParsedHttpUrlLogicLocal`.
///
/// # Examples
///
/// ```rust,ignore
/// let _ = std::mem::size_of::<pharos_native::runtime::business::ParsedHttpUrlLogicLocal>();
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for constructors, helpers, and neighboring runtime types.
pub struct ParsedHttpUrlLogicLocal {
    pub scheme: String,
    pub host: String,
    pub port: u16,
    pub path: String,
}

/// Appends bytes logic local.
///
/// # Parameters
///
/// - `buffer`: Input consumed by [`crate::runtime::business::append_bytes_logic_local`].
/// - `chunk`: Input consumed by [`crate::runtime::business::append_bytes_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_bytes_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_bytes_logic_local(&mut [], todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_bytes_logic_local(buffer: &mut Vec<u8>, chunk: &[u8]) -> bool {
    if buffer.len().saturating_add(chunk.len()) > MAX_INPUT_BYTES {
        return false;
    }
    buffer.extend_from_slice(chunk);
    true
}

/// Performs input field value dup logic local.
///
/// # Parameters
///
/// - `fields`: Input consumed by [`crate::runtime::business::input_field_value_dup_logic_local`].
/// - `field_id`: Input consumed by [`crate::runtime::business::input_field_value_dup_logic_local`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::input_field_value_dup_logic_local`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::input_field_value_dup_logic_local(todo!(), "field");
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn input_field_value_dup_logic_local(
    fields: &Map<String, Value>,
    field_id: &str,
) -> Option<String> {
    if field_id.is_empty() {
        return None;
    }
    fields.get(field_id).map(|value| value_text(Some(value)))
}

/// Appends bounded business text without allowing capacity overflow.
///
/// # Parameters
///
/// - `buffer`: Input consumed by [`crate::runtime::business::append_text_business_logic_local`].
/// - `text`: Input consumed by [`crate::runtime::business::append_text_business_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_text_business_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_text_business_logic_local(&mut [], "{}");
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_text_business_logic_local(buffer: &mut String, text: &str) -> bool {
    if buffer.len().saturating_add(text.len()) > MAX_INPUT_BYTES {
        return false;
    }
    buffer.push_str(text);
    true
}

/// Formats a validated clock value using the requested bounded format.
///
/// # Parameters
///
/// - `value`: Input consumed by [`crate::runtime::business::formatted_clock_time_business_logic_local`].
/// - `time_format`: Input consumed by [`crate::runtime::business::formatted_clock_time_business_logic_local`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::formatted_clock_time_business_logic_local`] can produce a value and [`None`] otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::formatted_clock_time_business_logic_local`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::formatted_clock_time_business_logic_local("value", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn formatted_clock_time_business_logic_local(value: &str, time_format: &str) -> Option<String> {
    let parts: Vec<u32> = value
        .split(':')
        .map(str::parse)
        .collect::<Result<_, _>>()
        .ok()?;
    if parts.len() < 2 || parts[0] > 23 || parts[1] > 59 || parts.get(2).copied().unwrap_or(0) > 59
    {
        return None;
    }
    let hour = parts[0];
    let minute = parts[1];
    let second = parts.get(2).copied().unwrap_or(0);
    Some(match time_format {
        "%H:%M" => format!("{hour:02}:{minute:02}"),
        "%H:%M:%S" => format!("{hour:02}:{minute:02}:{second:02}"),
        "%I:%M %p" => format!(
            "{:02}:{minute:02} {}",
            if hour.is_multiple_of(12) {
                12
            } else {
                hour % 12
            },
            if hour < 12 { "AM" } else { "PM" }
        ),
        _ => format!("{hour:02}:{minute:02}"),
    })
}

/// Renders an app fragment from a JSON parameter document.
///
/// # Parameters
///
/// - `app_root`: Input consumed by [`crate::runtime::business::render_app_fragment_from_doc_business_logic_local`].
/// - `fragment_name`: Input consumed by [`crate::runtime::business::render_app_fragment_from_doc_business_logic_local`].
/// - `doc`: Input consumed by [`crate::runtime::business::render_app_fragment_from_doc_business_logic_local`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::render_app_fragment_from_doc_business_logic_local`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::render_app_fragment_from_doc_business_logic_local(std::path::Path::new("apps/dev_docs"), todo!(), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn render_app_fragment_from_doc_business_logic_local(
    app_root: &str,
    fragment_name: &str,
    doc: &Value,
) -> Option<String> {
    super::json_commands::render_app_fragment_from_doc(app_root, fragment_name, doc)
}

#[derive(Debug, Clone, Default, Eq, PartialEq)]
/// Public struct `BusinessAdminServiceListLogicLocal` used by this module.
///
/// # Fields
///
/// - `items`: Stored field on `BusinessAdminServiceListLogicLocal`.
///
/// # Examples
///
/// ```rust,ignore
/// let _ = std::mem::size_of::<pharos_native::runtime::business::BusinessAdminServiceListLogicLocal>();
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for constructors, helpers, and neighboring runtime types.
pub struct BusinessAdminServiceListLogicLocal {
    pub items: Vec<BusinessAdminServiceLogicLocal>,
}

/// Releases a business service list using normal Rust ownership.
///
/// # Parameters
///
/// - `list`: Input consumed by [`crate::runtime::business::free_business_admin_service_list_logic_local`].
///
/// # Returns
///
/// Returns after [`crate::runtime::business::free_business_admin_service_list_logic_local`] applies its in-place effect.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::free_business_admin_service_list_logic_local(todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn free_business_admin_service_list_logic_local(list: &mut BusinessAdminServiceListLogicLocal) {
    list.items.clear();
}

/// Adds one service to a stable sort list after validating its identity.
///
/// # Parameters
///
/// - `list`: Input consumed by [`crate::runtime::business::append_business_admin_service_logic_local`].
/// - `service`: Input consumed by [`crate::runtime::business::append_business_admin_service_logic_local`].
/// - `sort_order`: Input consumed by [`crate::runtime::business::append_business_admin_service_logic_local`].
/// - `service_id`: Input consumed by [`crate::runtime::business::append_business_admin_service_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::append_business_admin_service_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::append_business_admin_service_logic_local(todo!(), todo!(), todo!(), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn append_business_admin_service_logic_local(
    list: &mut BusinessAdminServiceListLogicLocal,
    service: &Value,
    sort_order: i64,
    service_id: i64,
) -> bool {
    if !service.is_object() || service_id <= 0 {
        return false;
    }
    list.items.push(BusinessAdminServiceLogicLocal {
        sort_order,
        service_id,
    });
    true
}

/// Collects services belonging to one business from a JSON array.
///
/// # Parameters
///
/// - `services`: Input consumed by [`crate::runtime::business::collect_business_service_list_logic_local`].
/// - `business_id`: Input consumed by [`crate::runtime::business::collect_business_service_list_logic_local`].
/// - `list`: Input consumed by [`crate::runtime::business::collect_business_service_list_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::collect_business_service_list_logic_local`] holds and `false` otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::collect_business_service_list_logic_local`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::collect_business_service_list_logic_local(todo!(), todo!(), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn collect_business_service_list_logic_local(
    services: &Value,
    business_id: i64,
    list: &mut BusinessAdminServiceListLogicLocal,
) -> bool {
    let Some(services) = services.as_array() else {
        return false;
    };
    for service in services {
        if json_long(service, "business_id", 0) != business_id {
            continue;
        }
        let service_id = json_long(service, "id", 0);
        let sort_order = json_long(service, "sort_order", i64::MAX);
        if !append_business_admin_service_logic_local(list, service, sort_order, service_id) {
            return false;
        }
    }
    list.items
        .sort_by(compare_business_admin_service_logic_local);
    true
}

/// Finds one service by its positive numeric identifier.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::find_service_by_id_logic_local`].
/// - `service_id`: Input consumed by [`crate::runtime::business::find_service_by_id_logic_local`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::find_service_by_id_logic_local`] can produce a value and [`None`] otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::find_service_by_id_logic_local`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::find_service_by_id_logic_local(std::path::Path::new("."), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn find_service_by_id_logic_local(root: &Value, service_id: i64) -> Option<&Value> {
    root.get("services")?
        .as_array()?
        .iter()
        .find(|service| json_long(service, "id", 0) == service_id)
}

/// Serializes an owned document compactly for a response body.
///
/// # Parameters
///
/// - `doc`: Input consumed by [`crate::runtime::business::mut_doc_to_json_logic_local`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::mut_doc_to_json_logic_local`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::mut_doc_to_json_logic_local(todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn mut_doc_to_json_logic_local(doc: &Value) -> Option<String> {
    serde_json::to_string(doc).ok()
}

#[derive(Debug, Clone, Default, Eq, PartialEq)]
/// Public struct `BusinessLogicTextBufferLocal` used by this module.
///
/// # Fields
///
/// - `text`: Stored field on `BusinessLogicTextBufferLocal`.
///
/// # Examples
///
/// ```rust,ignore
/// let _ = std::mem::size_of::<pharos_native::runtime::business::BusinessLogicTextBufferLocal>();
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for constructors, helpers, and neighboring runtime types.
pub struct BusinessLogicTextBufferLocal {
    pub text: String,
}

/// Releases a business page text buffer.
///
/// # Parameters
///
/// - `buffer`: Input consumed by [`crate::runtime::business::text_buffer_free_business_logic_local`].
///
/// # Returns
///
/// Returns after [`crate::runtime::business::text_buffer_free_business_logic_local`] applies its in-place effect.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::text_buffer_free_business_logic_local(&mut []);
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn text_buffer_free_business_logic_local(buffer: &mut BusinessLogicTextBufferLocal) {
    buffer.text.clear();
}

/// Reserves bounded space for a business page text buffer.
///
/// # Parameters
///
/// - `buffer`: Input consumed by [`crate::runtime::business::text_buffer_reserve_business_logic_local`].
/// - `needed_length`: Input consumed by [`crate::runtime::business::text_buffer_reserve_business_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::text_buffer_reserve_business_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::text_buffer_reserve_business_logic_local(&mut [], todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn text_buffer_reserve_business_logic_local(
    buffer: &mut BusinessLogicTextBufferLocal,
    needed_length: usize,
) -> bool {
    needed_length <= MAX_INPUT_BYTES
        && buffer
            .text
            .try_reserve(needed_length.saturating_sub(buffer.text.len()))
            .is_ok()
}

/// Appends text to a business page buffer.
///
/// # Parameters
///
/// - `buffer`: Input consumed by [`crate::runtime::business::text_buffer_append_text_business_logic_local`].
/// - `text`: Input consumed by [`crate::runtime::business::text_buffer_append_text_business_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::text_buffer_append_text_business_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::text_buffer_append_text_business_logic_local(&mut [], "{}");
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn text_buffer_append_text_business_logic_local(
    buffer: &mut BusinessLogicTextBufferLocal,
    text: &str,
) -> bool {
    if !text_buffer_reserve_business_logic_local(
        buffer,
        buffer.text.len().saturating_add(text.len()),
    ) {
        return false;
    }
    buffer.text.push_str(text);
    true
}

/// Takes ownership of a business page buffer.
///
/// # Parameters
///
/// - `buffer`: Input consumed by [`crate::runtime::business::text_buffer_take_business_logic_local`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::text_buffer_take_business_logic_local`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::text_buffer_take_business_logic_local(&mut []);
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn text_buffer_take_business_logic_local(
    buffer: &mut BusinessLogicTextBufferLocal,
) -> Option<String> {
    (!buffer.text.is_empty()).then(|| std::mem::take(&mut buffer.text))
}

/// Tests whether a JSON array contains one numeric value.
///
/// # Parameters
///
/// - `array`: Input consumed by [`crate::runtime::business::json_array_contains_long_business_logic_local`].
/// - `wanted`: Input consumed by [`crate::runtime::business::json_array_contains_long_business_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::json_array_contains_long_business_logic_local`] holds and `false` otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::json_array_contains_long_business_logic_local`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::json_array_contains_long_business_logic_local(todo!(), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn json_array_contains_long_business_logic_local(array: &Value, wanted: i64) -> bool {
    array
        .as_array()
        .is_some_and(|items| items.iter().any(|item| item.as_i64() == Some(wanted)))
}

/// Renders the empty-card fragment through the app-owned template contract.
///
/// # Parameters
///
/// - `app_root`: Input consumed by [`crate::runtime::business::render_empty_card_list_item_business_logic_local`].
/// - `message`: Input consumed by [`crate::runtime::business::render_empty_card_list_item_business_logic_local`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::render_empty_card_list_item_business_logic_local`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::render_empty_card_list_item_business_logic_local(std::path::Path::new("apps/dev_docs"), "example");
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn render_empty_card_list_item_business_logic_local(
    app_root: &str,
    message: &str,
) -> Option<String> {
    super::json_commands::render_app_fragment_from_doc(
        app_root,
        "templates/shared/fragments/empty_card_list_item.html",
        &serde_json::json!({ "message": message }),
    )
}

/// Applies the canonical manager authorization check.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::user_manages_business_logic_local`].
/// - `user_id`: Input consumed by [`crate::runtime::business::user_manages_business_logic_local`].
/// - `business_id`: Input consumed by [`crate::runtime::business::user_manages_business_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::user_manages_business_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::user_manages_business_logic_local(std::path::Path::new("."), 1, todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn user_manages_business_logic_local(root: &Value, user_id: i64, business_id: i64) -> bool {
    dynamic_user_manages_business(root, user_id, business_id)
}

/// Accepts only six-digit CSS colors with a leading hash.
///
/// # Parameters
///
/// - `text`: Input consumed by [`crate::runtime::business::hex_color_valid_business_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::hex_color_valid_business_logic_local`] holds and `false` otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::hex_color_valid_business_logic_local`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::hex_color_valid_business_logic_local("{}");
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn hex_color_valid_business_logic_local(text: &str) -> bool {
    text.len() == 7
        && text.as_bytes()[0] == b'#'
        && text.as_bytes()[1..]
            .iter()
            .all(|byte| byte.is_ascii_hexdigit())
}

/// Returns a validated color or the caller-provided fallback.
///
/// # Parameters
///
/// - `text`: Input consumed by [`crate::runtime::business::hex_color_or_default_business_logic_local`].
/// - `fallback`: Input consumed by [`crate::runtime::business::hex_color_or_default_business_logic_local`].
///
/// # Returns
///
/// Returns the computed value produced by [`crate::runtime::business::hex_color_or_default_business_logic_local`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::hex_color_or_default_business_logic_local("{}", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn hex_color_or_default_business_logic_local<'a>(text: &'a str, fallback: &'a str) -> &'a str {
    if hex_color_valid_business_logic_local(text) {
        text
    } else {
        fallback
    }
}

/// Finds one canonical UI ledger element by identifier.
///
/// # Parameters
///
/// - `ledger_root`: Input consumed by [`crate::runtime::business::find_ui_ledger_element_business_logic_local`].
/// - `element_id`: Input consumed by [`crate::runtime::business::find_ui_ledger_element_business_logic_local`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::find_ui_ledger_element_business_logic_local`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::find_ui_ledger_element_business_logic_local(todo!(), todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn find_ui_ledger_element_business_logic_local<'a>(
    ledger_root: &'a Value,
    element_id: &str,
) -> Option<&'a Value> {
    super::ui::ui_find_element(ledger_root, element_id)
}

/// Appends a business page fragment to a text buffer.
///
/// # Parameters
///
/// - `buffer`: Input consumed by [`crate::runtime::business::business_logic_text_buffer_append_format`].
/// - `formatted`: Input consumed by [`crate::runtime::business::business_logic_text_buffer_append_format`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::business_logic_text_buffer_append_format`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::business_logic_text_buffer_append_format(&mut [], todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn business_logic_text_buffer_append_format(
    buffer: &mut BusinessLogicTextBufferLocal,
    formatted: &str,
) -> bool {
    text_buffer_append_text_business_logic_local(buffer, formatted)
}

/// Appends a business page fragment to a text buffer.
///
/// # Parameters
///
/// - `buffer`: Input consumed by [`crate::runtime::business::business_logic_text_buffer_append_text`].
/// - `text`: Input consumed by [`crate::runtime::business::business_logic_text_buffer_append_text`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::business_logic_text_buffer_append_text`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::business_logic_text_buffer_append_text(&mut [], "{}");
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn business_logic_text_buffer_append_text(
    buffer: &mut BusinessLogicTextBufferLocal,
    text: &str,
) -> bool {
    text_buffer_append_text_business_logic_local(buffer, text)
}

/// Releases a business page fragment buffer.
///
/// # Parameters
///
/// - `buffer`: Input consumed by [`crate::runtime::business::business_logic_text_buffer_free`].
///
/// # Returns
///
/// Returns after [`crate::runtime::business::business_logic_text_buffer_free`] applies its in-place effect.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::business_logic_text_buffer_free(&mut []);
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn business_logic_text_buffer_free(buffer: &mut BusinessLogicTextBufferLocal) {
    text_buffer_free_business_logic_local(buffer);
}

/// Takes a business page fragment buffer.
///
/// # Parameters
///
/// - `buffer`: Input consumed by [`crate::runtime::business::business_logic_text_buffer_take`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::business_logic_text_buffer_take`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::business_logic_text_buffer_take(&mut []);
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn business_logic_text_buffer_take(
    buffer: &mut BusinessLogicTextBufferLocal,
) -> Option<String> {
    text_buffer_take_business_logic_local(buffer)
}

/// Reserves space for a business page fragment buffer.
///
/// # Parameters
///
/// - `buffer`: Input consumed by [`crate::runtime::business::business_logic_text_buffer_reserve`].
/// - `needed_length`: Input consumed by [`crate::runtime::business::business_logic_text_buffer_reserve`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::business_logic_text_buffer_reserve`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::business_logic_text_buffer_reserve(&mut [], todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn business_logic_text_buffer_reserve(
    buffer: &mut BusinessLogicTextBufferLocal,
    needed_length: usize,
) -> bool {
    text_buffer_reserve_business_logic_local(buffer, needed_length)
}

/// Renders a managed dashboard card through an app-owned template.
///
/// # Parameters
///
/// - `app_root`: Input consumed by [`crate::runtime::business::render_managed_entity_dashboard_card_html_business_logic_local`].
/// - `slug`: Input consumed by [`crate::runtime::business::render_managed_entity_dashboard_card_html_business_logic_local`].
/// - `name`: Input consumed by [`crate::runtime::business::render_managed_entity_dashboard_card_html_business_logic_local`].
/// - `description`: Input consumed by [`crate::runtime::business::render_managed_entity_dashboard_card_html_business_logic_local`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::render_managed_entity_dashboard_card_html_business_logic_local`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::render_managed_entity_dashboard_card_html_business_logic_local(std::path::Path::new("apps/dev_docs"), todo!(), "name", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn render_managed_entity_dashboard_card_html_business_logic_local(
    app_root: &str,
    slug: &str,
    name: &str,
    description: &str,
) -> Option<String> {
    super::json_commands::render_app_fragment_from_doc(
        app_root,
        "templates/businesses/fragments/managed_entity_dashboard_card.html",
        &serde_json::json!({ "slug": slug, "name": name, "description": description }),
    )
}

/// Returns the numeric value of one hexadecimal digit.
///
/// # Parameters
///
/// - `character`: Input consumed by [`crate::runtime::business::hex_digit_value`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::hex_digit_value`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::hex_digit_value(todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn hex_digit_value(character: char) -> Option<u8> {
    character.to_digit(16).map(|value| value as u8)
}

/// Decodes a URL component with strict UTF-8 validation.
///
/// # Parameters
///
/// - `encoded`: Input consumed by [`crate::runtime::business::dynamic_url_decode`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::dynamic_url_decode`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dynamic_url_decode(todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dynamic_url_decode(encoded: &str) -> Option<String> {
    let mut bytes = Vec::with_capacity(encoded.len());
    let raw = encoded.as_bytes();
    let mut index = 0usize;
    while index < raw.len() {
        match raw[index] {
            b'+' => {
                bytes.push(b' ');
                index += 1;
            }
            b'%' if index + 2 < raw.len() => {
                bytes.push(
                    hex_digit_value(raw[index + 1] as char)? * 16
                        + hex_digit_value(raw[index + 2] as char)?,
                );
                index += 3;
            }
            b'%' => return None,
            byte => {
                bytes.push(byte);
                index += 1;
            }
        }
    }
    String::from_utf8(bytes).ok()
}

/// Extracts one separator-delimited key/value with URL decoding.
///
/// # Parameters
///
/// - `source`: Input consumed by [`crate::runtime::business::extract_value_for_key`].
/// - `key`: Input consumed by [`crate::runtime::business::extract_value_for_key`].
/// - `separator`: Input consumed by [`crate::runtime::business::extract_value_for_key`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::extract_value_for_key`] can produce a value and [`None`] otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::extract_value_for_key`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::extract_value_for_key(todo!(), "key", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn extract_value_for_key(source: &str, key: &str, separator: char) -> Option<String> {
    if key.is_empty() {
        return None;
    }
    source.split(separator).find_map(|pair| {
        let (candidate, value) = pair.split_once('=')?;
        (dynamic_url_decode(candidate).as_deref() == Some(key))
            .then(|| dynamic_url_decode(value))
            .flatten()
    })
}

/// Renders a generated admin fragment from an app-owned file.
///
/// # Parameters
///
/// - `app_root`: Input consumed by [`crate::runtime::business::render_generated_admin_fragment`].
/// - `fragment_name`: Input consumed by [`crate::runtime::business::render_generated_admin_fragment`].
/// - `params_root`: Input consumed by [`crate::runtime::business::render_generated_admin_fragment`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::render_generated_admin_fragment`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::render_generated_admin_fragment(std::path::Path::new("apps/dev_docs"), todo!(), &serde_json::json!({}));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn render_generated_admin_fragment(
    app_root: &str,
    fragment_name: &str,
    params_root: &Value,
) -> Option<String> {
    super::json_commands::render_app_fragment_from_doc(app_root, fragment_name, params_root)
}

/// Identifies framework-shared fragment names.
///
/// # Parameters
///
/// - `fragment_name`: Input consumed by [`crate::runtime::business::shared_asset_fragment_path`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::shared_asset_fragment_path`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::shared_asset_fragment_path(todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn shared_asset_fragment_path(fragment_name: &str) -> bool {
    super::json_commands::shared_asset_fragment_path_json(fragment_name)
}

/// Renders a shared fragment through the app-owned template loader.
///
/// # Parameters
///
/// - `app_root`: Input consumed by [`crate::runtime::business::render_shared_asset_fragment`].
/// - `fragment_name`: Input consumed by [`crate::runtime::business::render_shared_asset_fragment`].
/// - `params_root`: Input consumed by [`crate::runtime::business::render_shared_asset_fragment`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::render_shared_asset_fragment`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::render_shared_asset_fragment(std::path::Path::new("apps/dev_docs"), todo!(), &serde_json::json!({}));
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn render_shared_asset_fragment(
    app_root: &str,
    fragment_name: &str,
    params_root: &Value,
) -> Option<String> {
    super::json_commands::render_shared_asset_fragment_json(app_root, fragment_name, params_root)
}

/// Returns the SHA-256 right rotation primitive.
///
/// # Parameters
///
/// - `value`: Input consumed by [`crate::runtime::business::sha256_rotr`].
/// - `bits`: Input consumed by [`crate::runtime::business::sha256_rotr`].
///
/// # Returns
///
/// Returns the computed value produced by [`crate::runtime::business::sha256_rotr`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::sha256_rotr("value", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn sha256_rotr(value: u32, bits: u32) -> u32 {
    value.rotate_right(bits % 32)
}

/// Creates a streaming SHA-256 context.
///
/// # Related
///
/// - [`crate::runtime::business`] for neighboring helpers and related types.
///
/// # Examples
///
/// ```rust,ignore
/// let _ = std::mem::size_of::<pharos_native::runtime::business::Sha256Runtime>();
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for constructors, helpers, and neighboring runtime types.
pub type Sha256Runtime = Sha256;
/// Performs SHA-256 init.
///
/// # Returns
///
/// Returns the computed value produced by [`crate::runtime::business::sha256_init`].
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::sha256_init`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::sha256_init();
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn sha256_init() -> Sha256Runtime {
    Sha256::new()
}

/// Updates a streaming SHA-256 context.
///
/// # Parameters
///
/// - `context`: Input consumed by [`crate::runtime::business::sha256_update`].
/// - `data`: Input consumed by [`crate::runtime::business::sha256_update`].
///
/// # Returns
///
/// Returns after [`crate::runtime::business::sha256_update`] applies its in-place effect.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::sha256_update(todo!(), b"");
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn sha256_update(context: &mut Sha256Runtime, data: &[u8]) {
    context.update(data);
}

/// Completes a streaming SHA-256 context.
///
/// # Parameters
///
/// - `context`: Input consumed by [`crate::runtime::business::sha256_final`].
///
/// # Returns
///
/// Returns the computed value produced by [`crate::runtime::business::sha256_final`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::sha256_final(todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn sha256_final(context: Sha256Runtime) -> [u8; 32] {
    context.finalize().into()
}

/// Applies one bounded SHA-256 transform chunk.
///
/// # Parameters
///
/// - `context`: Input consumed by [`crate::runtime::business::sha256_transform`].
/// - `data`: Input consumed by [`crate::runtime::business::sha256_transform`].
///
/// # Returns
///
/// Returns after [`crate::runtime::business::sha256_transform`] applies its in-place effect.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::sha256_transform(todo!(), b"");
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn sha256_transform(context: &mut Sha256Runtime, data: &[u8]) {
    context.update(data);
}

/// Converts bytes to lowercase hexadecimal text.
///
/// # Parameters
///
/// - `bytes`: Input consumed by [`crate::runtime::business::bytes_to_hex`].
///
/// # Returns
///
/// Returns the computed value produced by [`crate::runtime::business::bytes_to_hex`].
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::bytes_to_hex`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::bytes_to_hex(b"");
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn bytes_to_hex(bytes: &[u8]) -> String {
    pharos_runtime_core::support::hex_digest(bytes)
}

/// Resolves one user-configured value from JSON configuration text.
///
/// # Parameters
///
/// - `path`: Input consumed by [`crate::runtime::business::conf_lookup_value`].
/// - `key`: Input consumed by [`crate::runtime::business::conf_lookup_value`].
///
/// # Returns
///
/// Returns [`Some`] when [`crate::runtime::business::conf_lookup_value`] can produce a value and [`None`] otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::conf_lookup_value(std::path::Path::new("fixture.json"), "key");
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn conf_lookup_value(path: &Path, key: &str) -> Option<String> {
    super::json_commands::conf_lookup_value(path, key)
}

/// Validates a generated-surface UI data key against the declarative contract.
///
/// # Parameters
///
/// - `key`: Input consumed by [`crate::runtime::business::dynamic_business_ui_data_key_allowed`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::dynamic_business_ui_data_key_allowed`] holds and `false` otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::dynamic_business_ui_data_key_allowed`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dynamic_business_ui_data_key_allowed("key");
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dynamic_business_ui_data_key_allowed(key: &str) -> bool {
    !key.is_empty()
        && key.len() <= 128
        && key
            .bytes()
            .all(|byte| byte.is_ascii_alphanumeric() || matches!(byte, b'_' | b'-'))
}

/// Checks for an active tenant membership row.
///
/// # Parameters
///
/// - `root`: Input consumed by [`crate::runtime::business::dynamic_user_has_active_tenant_membership`].
/// - `user_id`: Input consumed by [`crate::runtime::business::dynamic_user_has_active_tenant_membership`].
/// - `tenant_id`: Input consumed by [`crate::runtime::business::dynamic_user_has_active_tenant_membership`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::dynamic_user_has_active_tenant_membership`] holds and `false` otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::dynamic_user_has_active_tenant_membership`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::dynamic_user_has_active_tenant_membership(std::path::Path::new("."), 1, todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn dynamic_user_has_active_tenant_membership(
    root: &Value,
    user_id: i64,
    tenant_id: i64,
) -> bool {
    if user_id <= 0 || tenant_id <= 0 {
        return false;
    }
    root.get("tenant_memberships")
        .and_then(Value::as_array)
        .is_some_and(|rows| {
            rows.iter().any(|row| {
                json_long(row, "user_id", 0) == user_id
                    && json_long(row, "tenant_id", 0) == tenant_id
                    && row
                        .get("membership_status")
                        .and_then(Value::as_str)
                        .is_none_or(|status| status.is_empty() || status == "active")
            })
        })
}

/// Converts a JSON integer value and reports whether conversion succeeded.
///
/// # Parameters
///
/// - `value`: Input consumed by [`crate::runtime::business::long_from_value_business_logic_local`].
/// - `output`: Input consumed by [`crate::runtime::business::long_from_value_business_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::long_from_value_business_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::long_from_value_business_logic_local("value", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn long_from_value_business_logic_local(value: &Value, output: &mut i64) -> bool {
    let Some(number) = value.as_i64() else {
        return false;
    };
    *output = number;
    true
}

/// Compares a JSON integer value with an expected value.
///
/// # Parameters
///
/// - `value`: Input consumed by [`crate::runtime::business::value_long_equals_business_logic_local`].
/// - `expected_value`: Input consumed by [`crate::runtime::business::value_long_equals_business_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::value_long_equals_business_logic_local`] holds and `false` otherwise.
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::value_long_equals_business_logic_local("value", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn value_long_equals_business_logic_local(value: &Value, expected_value: i64) -> bool {
    value.as_i64() == Some(expected_value)
}

/// Parses an HH:MM clock value into minutes since midnight.
///
/// # Parameters
///
/// - `value`: Input consumed by [`crate::runtime::business::time_text_to_minutes_business_logic_local`].
/// - `minutes_out`: Input consumed by [`crate::runtime::business::time_text_to_minutes_business_logic_local`].
///
/// # Returns
///
/// Returns `true` when the condition checked by [`crate::runtime::business::time_text_to_minutes_business_logic_local`] holds and `false` otherwise.
///
/// # Performance
///
/// Performance is proportional to the size of the supplied inputs and any parsed or loaded data consumed by [`crate::runtime::business::time_text_to_minutes_business_logic_local`].
///
/// # Examples
///
/// ```rust,ignore
/// let _result = pharos_native::runtime::business::time_text_to_minutes_business_logic_local("value", todo!());
/// ```
///
/// # Related
///
/// - [`crate::runtime::business`] for adjacent helpers that share the same runtime surface.
pub fn time_text_to_minutes_business_logic_local(value: &str, minutes_out: &mut i32) -> bool {
    let mut parts = value.split(':');
    let hour = parts.next().and_then(|part| part.parse::<i32>().ok());
    let minute = parts.next().and_then(|part| part.parse::<i32>().ok());
    if parts.next().is_some()
        || hour.is_none_or(|hour| !(0..=23).contains(&hour))
        || minute.is_none_or(|minute| !(0..=59).contains(&minute))
    {
        return false;
    }
    *minutes_out = hour.unwrap_or_default() * 60 + minute.unwrap_or_default();
    true
}

#[cfg(test)]
mod tests {
    use super::*;
    use serde_json::json;

    #[test]
    fn assign_technician_skips_booked_technician_and_rejects_full_slots() {
        let mut root = json!({
            "technicians": [
                {
                    "id": 100,
                    "business_id": 5,
                    "name": "Mika"
                },
                {
                    "id": 101,
                    "business_id": 5,
                    "name": "Jun"
                },
                {
                    "id": 102,
                    "business_id": 5,
                    "name": "Priya"
                }
            ],
            "businesses": [
                {
                    "id": 5,
                    "slug": "lotus-studio",
                    "name": "Lotus Thai Massage"
                }
            ],
            "services": [
                {
                    "id": 10,
                    "business_id": 5,
                    "cost": "40",
                    "duration_minutes": 60,
                    "technician_ids": [100, 101],
                    "booking_options": [
                        {
                            "label": "Extended",
                            "duration_minutes": 90,
                            "cost": "115.00"
                        }
                    ]
                }
            ],
            "business_availability": [
                {
                    "business_id": 5,
                    "day_of_week": "Wed",
                    "start_time": "08:00",
                    "end_time": "16:00"
                }
            ],
            "technician_availability": [
                {
                    "technician_id": 100,
                    "day_of_week": "Wed",
                    "start_time": "08:00",
                    "end_time": "16:00"
                },
                {
                    "technician_id": 101,
                    "day_of_week": "Wed",
                    "start_time": "08:00",
                    "end_time": "16:00"
                }
            ],
            "appointments": [
                {
                    "id": 1,
                    "business_id": 5,
                    "service_id": 10,
                    "technician_id": 100,
                    "date": "2026-09-30",
                    "time": "08:00",
                    "status": "confirmed"
                }
            ]
        });

        assert!(dynamic_business_open_for_slot(
            &json!({
                "business_availability": [
                    {
                        "business_id": 5,
                        "day_of_week": "Wed",
                        "start_time": "08:00",
                        "end_time": "16:00"
                    }
                ]
            }),
            5,
            "2026-09-30",
            "08:00",
            60,
        ));
        assert_eq!(
            dynamic_assign_technician_for_slot(&root, 5, 10, "2026-09-30", "08:00"),
            101
        );
        assert!(dynamic_technician_available_for_slot(
            &root,
            5,
            10,
            100,
            "2026-09-30",
            "08:00",
            1,
        ));

        root["appointments"]
            .as_array_mut()
            .expect("appointment rows")
            .push(json!({
                "id": 2,
                "business_id": 5,
                "service_id": 10,
                "technician_id": 101,
                "date": "2026-09-30",
                "time": "08:00",
                "status": "confirmed"
            }));

        assert_eq!(
            dynamic_assign_technician_for_slot(&root, 5, 10, "2026-09-30", "08:00"),
            0
        );
        assert!(!dynamic_technician_available_for_slot(
            &root,
            5,
            10,
            101,
            "2026-09-30",
            "08:00",
            1,
        ));
        assert!(dynamic_technician_unbooked_for_slot(
            &root,
            5,
            102,
            "2026-09-30",
            "08:00",
            60,
            1,
        ));

        let mut assign_form = serde_json::Map::from_iter([
            ("appointment_id".to_owned(), Value::from(1)),
            ("technician_id".to_owned(), Value::from(102)),
        ]);
        handle_assign_appointment_technician_booking_local(&mut root, &assign_form)
            .expect("same-business unbooked technician is assignable");
        assert_eq!(row_i64(&root["appointments"][0], "technician_id"), 102);

        assign_form.insert("technician_id".to_owned(), Value::from(101));
        assert_eq!(
            handle_assign_appointment_technician_booking_local(&mut root, &assign_form),
            Err(409)
        );

        let create_form = serde_json::Map::from_iter([
            ("business_id".to_owned(), Value::from(5)),
            ("service_id".to_owned(), Value::from(10)),
            ("booking_option_index".to_owned(), Value::from(0)),
            ("user_id".to_owned(), Value::from(42)),
            ("technician_id".to_owned(), Value::from(101)),
            ("date".to_owned(), Value::from("2026-09-30")),
            ("time".to_owned(), Value::from("10:00")),
            ("notes".to_owned(), Value::from("Internal booking")),
        ]);
        handle_create_appointment_booking_local(&mut root, &create_form)
            .expect("internal appointment is created");
        let created = root["appointments"].as_array().unwrap().last().unwrap();
        assert_eq!(row_i64(created, "technician_id"), 101);
        assert_eq!(row_i64(created, "service_duration_minutes"), 90);
        assert_eq!(value_text(created.get("service_cost")), "115.00");
        assert_eq!(value_text(created.get("payment_mode")), "internal");
    }

    #[test]
    fn update_business_preserves_hidden_public_state_and_saves_declared_fields() {
        let mut root = json!({
            "businesses": [
                {
                    "id": 5,
                    "name": "Lotus Thai Massage",
                    "slug": "lotus-studio",
                    "description": "Old description",
                    "address": "Old address",
                    "is_public": true,
                    "time_format": "am_pm",
                    "secondary_color": "#2563eb",
                    "image_url": "/media/businesses/old.png"
                }
            ]
        });
        let form = serde_json::Map::from_iter([
            ("business_id".to_owned(), Value::from(5)),
            ("name".to_owned(), Value::from("Lotus Thai Massage Updated")),
            ("description".to_owned(), Value::from("New description")),
            ("address".to_owned(), Value::from("New address")),
            ("time_format".to_owned(), Value::from("24_hour")),
            (
                "business_edit_secondary_color_hex".to_owned(),
                Value::from("#22c55e"),
            ),
        ]);

        handle_update_business_identity_local(&mut root, &form).expect("business update");

        let business = root["businesses"][0].as_object().expect("business object");
        assert_eq!(
            business.get("name").and_then(Value::as_str),
            Some("Lotus Thai Massage Updated")
        );
        assert_eq!(
            business.get("description").and_then(Value::as_str),
            Some("New description")
        );
        assert_eq!(
            business.get("address").and_then(Value::as_str),
            Some("New address")
        );
        assert_eq!(
            business.get("is_public").and_then(Value::as_bool),
            Some(true)
        );
        assert_eq!(
            business.get("time_format").and_then(Value::as_str),
            Some("24_hour")
        );
        assert_eq!(
            business.get("secondary_color").and_then(Value::as_str),
            Some("#22c55e")
        );
        assert_eq!(
            business.get("image_url").and_then(Value::as_str),
            Some("/media/businesses/old.png")
        );
    }

    #[test]
    fn update_business_remove_logo_clears_image_url() {
        let mut root = json!({
            "businesses": [
                {
                    "id": 5,
                    "name": "Lotus Thai Massage",
                    "slug": "lotus-studio",
                    "description": "",
                    "address": "",
                    "is_public": true,
                    "time_format": "am_pm",
                    "secondary_color": "#2563eb",
                    "image_url": "/media/businesses/old.png"
                }
            ]
        });
        let form = serde_json::Map::from_iter([
            ("business_id".to_owned(), Value::from(5)),
            ("name".to_owned(), Value::from("Lotus Thai Massage")),
            ("remove_logo".to_owned(), Value::from("1")),
        ]);

        handle_update_business_identity_local(&mut root, &form).expect("business update");

        assert_eq!(
            root["businesses"][0]
                .get("image_url")
                .and_then(Value::as_str),
            Some("")
        );
    }
}