b84f860d86
Complete the A-to-Z Lardon3D maintenance and coherence pass. Generalize host resource policy, remove the global CPU12 ceiling, preserve host CPU/RAM reserves, scale Task capabilities through the Resource Governor, and validate deterministic parallel GV execution. Migrate Project DB to v23 with data-driven camera, lens, optical configuration and calibration profiles, including manual lenses without EXIF. Integrate safe optional LARDON SSD swap/scratch control with Governor and F10 drain/safe-to-unplug semantics. Refactor the ncurses TUI into a runtime observatory with durable progress, elapsed time, smoothed ETA, throughput, resource telemetry, Governor state, optics workflow, colors and compact/no-color fallbacks. Reconcile Queue lifetime, persistence, concurrency, comments, tests, README, AGENTS and canonical documentation. GLOBAL_MAINTENANCE_AUDIT=PASS/FROZEN
52 lines
2.2 KiB
C
52 lines
2.2 KiB
C
#ifndef LARDON3D_GEOMETRIC_VERIFIER_INTERNAL_H
|
|
#define LARDON3D_GEOMETRIC_VERIFIER_INTERNAL_H
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
|
|
#include <lardon3d/geometric_verifier.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct Lardon3DGeometricVerifierPrepared
|
|
Lardon3DGeometricVerifierPrepared;
|
|
|
|
/* Worker-owned preparation validates every immutable input and computes the
|
|
* exact frozen v1/v2/v3 scientific payload, but never mutates Project DB. If
|
|
* the exact identity already exists, `prepared` remains NULL and the
|
|
* caller-owned `result` is filled with that durable row. Otherwise the caller
|
|
* owns one bounded opaque preparation until destroy, including on publication
|
|
* failure. Independent preparations may run concurrently against the shared,
|
|
* internally serialized Project DB handle. Every Match/Feature file handle is
|
|
* owned by one preparation call and closed before that call returns. */
|
|
Lardon3DGeometricVerifierResult
|
|
lardon3d_geometric_verifier_internal_prepare_version(
|
|
const char *project_path, Lardon3DProjectDb *database,
|
|
uint64_t match_result_id,
|
|
const Lardon3DGeometricVerifierParameters *parameters,
|
|
uint32_t verifier_version, Lardon3DGeometricVerifierPrepared **prepared,
|
|
Lardon3DProjectDbGeometricVerificationResult *result, bool *reused);
|
|
|
|
/* The sequence owner alone publishes prepared payloads in canonical parent
|
|
* order. Retry is exact: a concurrent/existing identical row is returned as
|
|
* reuse, while no different identity is inferred. The function does not
|
|
* consume `prepared`; destroy remains mandatory after every return. */
|
|
Lardon3DGeometricVerifierResult
|
|
lardon3d_geometric_verifier_internal_publish_prepared(
|
|
Lardon3DProjectDb *database,
|
|
const Lardon3DGeometricVerifierPrepared *prepared,
|
|
Lardon3DProjectDbGeometricVerificationResult *result, bool *reused);
|
|
|
|
/* Releases one preparation. NULL is accepted so a batch cleanup sweep remains
|
|
* safe after clearing owned slots; every non-NULL object must be released
|
|
* exactly once on partial thread creation, cancellation, success, or failure. */
|
|
void lardon3d_geometric_verifier_internal_prepared_destroy(
|
|
Lardon3DGeometricVerifierPrepared *prepared);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|