@maschinenlesbar.org/openka-cli
    Preparing search index...

    Interface DiscoverOptions

    interface DiscoverOptions {
        apiKey?: string;
        engine: FetchEngine;
        force?: boolean;
        ignoreRobots?: boolean;
        limit?: number;
        period?: number;
        robots?: RobotsPolicy;
        since?: string;
        state: SourceState;
        store?: Pick<Store, "loadArtifact">;
        until?: string;
    }
    Index
    apiKey?: string

    Credential for sources that need one, already resolved from flag or env.

    engine: FetchEngine
    force?: boolean

    Ignore cached validators and re-read the upstream feed. Without this a source that answers 304 would report "nothing changed" even when the caller asked for a full re-extraction, which makes ka sync --force silently do nothing.

    ignoreRobots?: boolean

    Fetch from a server whose robots.txt disallows it.

    Off by default, and never inferred: it is a flag the operator typed. Two Länder publish their Drucksachen openly and disallow every client in robots.txt, so this is the switch that decides whether their documents can be read at all. It is not silent — the run warns, once per host, that it was used. The records do not carry that warning.

    limit?: number

    Stop after this many refs.

    period?: number

    Restrict to one legislative period.

    robots?: RobotsPolicy

    The run's robots.txt policy, when the caller has one. A connector that gates its discovery on a document server (robotsGate) asks this one, so the pipeline's later per-document checks reuse the same reading of the file: one robots.txt request per host per run, and no chance of two different answers in one run.

    since?: string

    Only Anfragen dated on or after this ISO date.

    Per-source state from the corpus: conditional-request validators and history.

    store?: Pick<Store, "loadArtifact">

    The corpus, for a source that consumes a frozen artifact the factory built. Only Niedersachsen needs it, to read the question→answer map its sweep produces; discovery still never writes to the store.

    until?: string

    Only Anfragen dated on or before this ISO date.