dbimport

type Options struct {
	// AgenticScanUUID, if non-empty, attaches imported findings (and HTTP
	// records for JSONL) to an existing agentic_scan row instead of creating a
	// new one. For audit imports the existing row's metadata is preserved and
	// only finding counts/storage_url are touched.
	AgenticScanUUID string

	// OriginalSource carries the user-supplied input string (e.g. gs:// URL or
	// archive path). Recorded as StorageURL on audit scan rows when it has a
	// gs:// prefix.
	OriginalSource string

	// SessionDirArchiver, if non-nil, is invoked after the agentic scan UUID is
	// determined. It receives that UUID and the on-disk audit source dir,
	// and returns the absolute session directory where the source was copied.
	// Used by audit imports only.
	SessionDirArchiver func(scanUUID, srcDir string) (sessionDir string, err error)

	// Source identifies the audit harness flavor (audit vs piolium). When
	// zero-valued, audit.DefaultSource() is used.
	Source *audit.FindingSource

	// SkipHTTPRecords omits the http_records table from a SQLite→SQLite merge;
	// see database.MergeOptions. Ignored by the JSONL/audit/archive importers,
	// which don't carry a separate record table to skip.
	SkipHTTPRecords bool

	// SkipRecordBodies omits the raw_request/raw_response columns from a
	// SQLite→SQLite merge of http_records; see database.MergeOptions. Ignored by
	// the JSONL/audit/archive importers.
	SkipRecordBodies bool

	// SkipFindings omits findings, the finding_records junction, and
	// oast_interactions from a SQLite→SQLite merge; see database.MergeOptions.
	// Ignored by the JSONL/audit/archive importers, whose whole payload is
	// findings.
	SkipFindings bool

	// PreserveProjectUUID keeps each JSONL row's own project_uuid instead of
	// re-homing it onto the projectUUID argument. A row with no project_uuid of
	// its own still gets the argument.
	//
	// It exists for the read-only scratch databases: a `-S --db export.jsonl`
	// load and a --glob-db merge exist to show a file's contents as they are, and
	// stamping the default project over every row made `project_uuid` in the
	// output a statement about the reader rather than about the data — which also
	// made an explicit project filter over such a source meaningless.
	//
	// Persistent `vigolium import` deliberately does NOT set it: importing into a
	// project means the rows join that project.
	PreserveProjectUUID bool

	// MaxLineBytes caps a single JSONL line. 0 means DefaultMaxLineBytes.
	//
	// The reader grows its buffer to whatever a line needs, which is required —
	// an exported http_record carries its whole response body on one line. With
	// no ceiling at all, though, a truncated or non-JSONL file (a tarball, a core
	// dump, a file whose newlines were stripped) is read into memory in full
	// before the first parse error can be reported, so the symptom of pointing
	// `import` at the wrong file is the OOM killer rather than a message.
	MaxLineBytes int
}

type Result struct {
	AgenticScan *database.AgenticScan
	CreatedNew  bool

	RecordsImported int
	FindingsTotal   int
	FindingsSaved   int
	FindingsSkipped int
	ParseErrors     int

	// RecordsSkippedDuplicate counts HTTP records whose uuid was already in the
	// destination, so they were not inserted. Reported separately from
	// RecordsImported because "0 imported" out of a 10,000-line export means
	// something very different from "0 imported, 10,000 already present".
	RecordsSkippedDuplicate int

	// FindingsFailed counts findings the destination refused to store. Distinct
	// from FindingsSkipped, which is the benign dedup-append case: a failed
	// finding is data that was in the source and is NOT in the destination, and
	// folding the two together reported a lossy import as a clean one.
	FindingsFailed int

	SeverityCounts map[string]int
	SkippedTypes   map[string]int

	SessionDir string
	StorageURL string

	// MergeStats is populated only for SQLite-database imports (ImportSQLite):
	// a lossless SQLite→SQLite merge of another vigolium result database into
	// the destination. Nil for audit and JSONL imports.
	MergeStats *database.MergeStats
}