fy59
d65f9559e6
Preserve the local graph-first investigation stack through macro V1. Include reviewed source, tests, contracts, documentation and synthetic assets. Retain the standalone financial V21 test foundation without runtime migration. Runtime remains V20; operational JobStore remains V3. Local experimental checkpoint, not a stable release.
47 lines
1.9 KiB
C
47 lines
1.9 KiB
C
/******************************************************************************
|
|
* @file local_correlation_service.h
|
|
* @brief Index local typé et rapprochements explicables J7.
|
|
******************************************************************************/
|
|
#ifndef LABFY_INVESTIGATION_LOCAL_CORRELATION_SERVICE_H
|
|
#define LABFY_INVESTIGATION_LOCAL_CORRELATION_SERVICE_H
|
|
|
|
#include "database/database.h"
|
|
#include <gio/gio.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define LOCAL_CORRELATION_CONTRACT "labfy.local_correlation.snapshot.v1"
|
|
#define LOCAL_CORRELATION_RULE_VERSION "labfy.local_identifier_normalization.v1"
|
|
|
|
typedef struct {
|
|
guint max_observations;
|
|
guint max_groups;
|
|
guint max_connections;
|
|
gsize max_json_bytes;
|
|
} LocalCorrelationLimits;
|
|
|
|
/** Normalise une valeur typée selon la même règle que l'index. */
|
|
char *local_correlation_normalize(const char *type, const char *raw,
|
|
char **out_reason);
|
|
|
|
/**
|
|
* Construit une projection possédée depuis une lecture cohérente de SQLite.
|
|
*
|
|
* CONTRACT: le service ne modifie ni la base métier V20 ni le JobStore. Il
|
|
* indexe seulement `email_address`, `domain_name` et `ip_address`; les valeurs
|
|
* invalides ou rejetées restent visibles mais ne soutiennent aucun lien.
|
|
* Si l'appelant n'a pas de transaction active, le service possède un snapshot
|
|
* de lecture qu'il valide lui-même. Une transaction empruntée reste intacte.
|
|
* INVARIANT: le JSON retourné possède ses octets et doit être libéré avec
|
|
* `g_bytes_unref()`. Les compteurs de preuves et de contenus sont distincts.
|
|
*/
|
|
GBytes *local_correlation_service_build(Database *database,
|
|
const char *investigation_identifier, LocalCorrelationLimits limits,
|
|
GError **error);
|
|
|
|
/** Publie atomiquement avec un temporaire unique dans le même répertoire. */
|
|
gboolean local_correlation_snapshot_write_atomic(GBytes *snapshot,
|
|
const char *path, GError **error);
|
|
|
|
G_END_DECLS
|
|
#endif
|