@lssm-tech/lib.job-source-runtime
Provider-free primitives for named job-source connectors. The runtime separates discovery, acquisition, parsing, normalization, revalidation, and closure, while preserving deterministic replay and immutable evidence references.
Network access and source-specific behavior are injected through ports. Public intelligence remains in OSINT; candidate-private application actions are outside this package.
Account-gated installations carry only an opaque credentialRef. The injected acquisition adapter resolves it transiently; connectors never receive the credential value and fail closed when the reference or adapter is absent.
compileJobAcquisitionPlanV1 and assertJobAcquisitionPlanV1 bind an immutable request digest to a direct-first route list, policy revision, budget, qualified connection references, egress profiles, checkpoint, and expiry. Fallback routes must be strictly ordered, source-supported, and non-direct. Rebound, stale, fingerprint-mismatched, unqualified, or non-direct-first plans fail before any provider effect.
reconcileSuccessfulJobScanV1 deterministically compares one completed scan with tracked listings. Failed scans have no effect. Missing listings accumulate only successful absences and require a direct 404/410 detail receipt at the configured threshold unless explicit closure evidence already exists.
fingerprintJobSourceResourceSchemaV1 fingerprints response structure rather than values. Qualified installations persist that fingerprint and fail closed with breaking drift when a later successful detail response changes shape. Legacy unqualified fingerprints remain neutral until qualification captures a real response schema.
reconcileOperatorJobListingV1 (./operator-reconciliation) applies one operator revalidation or closure request to a tracked listing behind an explicit store port: unknown availability and revision conflicts fail before persistence, and closure still requires explicit evidence or a confirmed missing recheck.
./osint-observations binds a qualified OSINT source manifest to an installation, normalizes web-access acquisitions and snapshot evidence, and maps parsed listings to OSINT job observations. Deployment targeting is an injected port; the host decides which deployment applies it.
