native_runtime_reports.h

Go to the documentation of this file.

/**
 * @file
 * @brief Declares builders for native runtime report payloads.
 */
 
#ifndef PHAROS_NATIVE_RUNTIME_REPORTS_H
#define PHAROS_NATIVE_RUNTIME_REPORTS_H
 
#include "native_runtime_types.h"
 
/** @name Runtime report helpers
 * @{
 */
/**
 * @brief Builds a JSON report describing a native runtime build result.
 * @param target_id Runtime target identifier.
 * @param conf_path Runtime config file path.
 * @param apps_dir Resolved apps directory.
 * @param app_count Number of apps included in the runtime.
 * @return Newly allocated JSON report text, or NULL on failure.
 */
char *build_native_runtime_build_report_json(const char *target_id, const char *conf_path, const char *apps_dir, size_t app_count);
/**
 * @brief Builds a JSON status report for a loaded runtime stack.
 * @param stack Loaded runtime stack to summarize.
 * @param apps_dir Runtime apps directory represented by the stack.
 * @return Newly allocated JSON report text, or NULL on failure.
 */
char *build_native_runtime_status_report_json(const RuntimeStack *stack, const char *apps_dir);
/**
 * @brief Builds a JSON runtime report for one app artifact and host surface.
 * @param report_id Stable report identifier.
 * @param verb Report verb such as status or build.
 * @param host_target Host target label to report.
 * @param host_mode Host mode label to report.
 * @param artifact_dir Active artifact directory for the app.
 * @param app Finalized app runtime to summarize.
 * @return Newly allocated JSON report text, or NULL on failure.
 */
char *build_native_app_runtime_report_json(const char *report_id, const char *verb, const char *host_target, const char *host_mode, const char *artifact_dir, const AppRuntime *app);
 
 
/** @} */
#endif