@gzeoneth/gov-tracker 0.2.1-beta.e9f73a3 → 0.2.1-beta.f5af747

package/dist/cli/lib/cli.d.ts

@@ -12,7 +12,7 @@
  */
 import { Command, Option } from "commander";
 import { ethers } from "ethers";
-import { ProposalStageTracker, TrackingResult, TrackingCheckpoint, PreparedTransaction, PrepareResult, isElectionGovernor, DiscoveredProposal, DiscoveredTimelockOp, DiscoveryWatermarks } from "../../index";
+import { ProposalStageTracker, TrackingResult, TrackingCheckpoint, PreparedTransaction, PrepareResult, TrackerStats, isElectionGovernor, DiscoveredProposal, DiscoveredTimelockOp, DiscoveryWatermarks, DiscoveryTargets, ElectionProposalStatus } from "../../index";
 export { isElectionGovernor };
 /** Default block lag to prevent reorg issues */
 export declare const DEFAULT_BLOCK_LAG = 12;
@@ -67,6 +67,23 @@ export declare const gasOptions: Option[];
  */
 export declare const loopOptions: Option[];
 export declare function addOptions(cmd: Command, opts: Option[]): void;
+interface CommonCliOptions {
+    cache?: string;
+    noCache?: boolean;
+    force?: boolean;
+    startBlock?: string;
+    prepare?: boolean;
+    write?: boolean;
+    prepareCompleted?: boolean;
+    preparePending?: boolean;
+    inspect?: boolean;
+    inspectOnly?: boolean;
+}
+/**
+ * Validate CLI options for contradictions and conflicts.
+ * Throws an error if conflicting options are detected.
+ */
+export declare function validateCliOptions(opts: CommonCliOptions, command: "run" | "track"): void;
 /**
  * Parse gas settings from CLI options
  */
@@ -112,7 +129,19 @@ export declare function formatDryRun(prepared: PreparedTransaction): string;
  */
 export declare function formatMultiplePreparedTransactions(preparedTransactions: PreparedTransaction[]): string;
 export declare function formatTrackingResult(result: TrackingResult, label?: string): string;
-export declare function formatCacheStatus(checkpoints: Map<string, TrackingCheckpoint>): string;
+export declare function formatCacheStatus(checkpoints: Map<string, TrackingCheckpoint>, elections: Map<number, TrackingCheckpoint>): string;
+/**
+ * Format an election status for CLI output
+ */
+export declare function formatElectionResult(election: ElectionProposalStatus): string;
+/**
+ * Display a tracking result, automatically switching to election display for election proposals.
+ * Handles the election auto-switch logic internally, falling back to formatTrackingResult for non-elections.
+ *
+ * @param result - Tracking result to display
+ * @param label - Optional label prefix
+ */
+export declare function displayTrackingResult(result: TrackingResult, label?: string): void;
 /** Check if shutdown has been requested */
 export declare function isShuttingDown(): boolean;
 export declare function runWithLoop(cycleFn: () => Promise<void>, options: {
@@ -140,6 +169,12 @@ export interface MonitorRunOptions {
     maxAgeDays?: number;
     /** Number of concurrent tracking operations (default: 1 = sequential) */
     concurrency?: number;
+    /** Custom discovery targets (default: all enabled via buildDefaultTargets()) */
+    targets?: DiscoveryTargets;
+    /** Skip discovery and only track elections (faster when only elections needed) */
+    electionsOnly?: boolean;
+    /** Force re-track all elections, bypassing cache */
+    forceElections?: boolean;
 }
 export interface MonitorRunResult {
     tracked: number;
@@ -147,11 +182,22 @@ export interface MonitorRunResult {
     errors: number;
     retracked: number;
 }
+/**
+ * Filter checkpoints to only include those matching enabled discovery targets.
+ * Used for JSON output and stats to ensure we only show tracked types.
+ */
+export declare function filterCheckpointsByTargets(checkpoints: Map<string, TrackingCheckpoint>, targets: DiscoveryTargets): Map<string, TrackingCheckpoint>;
+/**
+ * Calculate stats filtered by enabled discovery targets.
+ * Only counts checkpoints that match the enabled governors/timelocks.
+ */
+export declare function calculateFilteredStats(checkpoints: Map<string, TrackingCheckpoint>, targets: DiscoveryTargets, maxErrorCount?: number): TrackerStats;
 export declare function runMonitorCycle(tracker: ProposalStageTracker, providers: ProviderBundle, options?: MonitorRunOptions): Promise<{
     result: MonitorRunResult;
     proposals: DiscoveredProposal[];
     timelockOps: DiscoveredTimelockOp[];
     watermarks: DiscoveryWatermarks;
+    elections: ElectionProposalStatus[];
 }>;
 export declare function trackAndPrepare(tracker: ProposalStageTracker, txHash: string, options: {
     prepare?: boolean;

package/dist/cli/lib/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/cli.ts"],"names":[],"mappings":"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"}

package/dist/cli/lib/cli.js

@@ -14,6 +14,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loopOptions = exports.gasOptions = exports.chunkingOptions = exports.executionOptions = exports.cacheOptions = exports.verboseOption = exports.rpcOptions = exports.HEALTH_CHECK_TIMEOUT_MS = exports.DEFAULT_L2_GAS_SETTINGS = exports.MAX_CONSECUTIVE_ERRORS = exports.DEFAULT_MAX_AGE_DAYS = exports.DEFAULT_BLOCK_LAG = exports.isElectionGovernor = void 0;
 exports.addOptions = addOptions;
+exports.validateCliOptions = validateCliOptions;
 exports.parseGasSettings = parseGasSettings;
 exports.parseChunkingConfig = parseChunkingConfig;
 exports.createProvidersFromOptions = createProvidersFromOptions;
@@ -24,8 +25,12 @@ exports.formatDryRun = formatDryRun;
 exports.formatMultiplePreparedTransactions = formatMultiplePreparedTransactions;
 exports.formatTrackingResult = formatTrackingResult;
 exports.formatCacheStatus = formatCacheStatus;
+exports.formatElectionResult = formatElectionResult;
+exports.displayTrackingResult = displayTrackingResult;
 exports.isShuttingDown = isShuttingDown;
 exports.runWithLoop = runWithLoop;
+exports.filterCheckpointsByTargets = filterCheckpointsByTargets;
+exports.calculateFilteredStats = calculateFilteredStats;
 exports.runMonitorCycle = runMonitorCycle;
 exports.trackAndPrepare = trackAndPrepare;
 const commander_1 = require("commander");
@@ -114,6 +119,59 @@ exports.loopOptions = [
 function addOptions(cmd, opts) {
     opts.forEach((o) => cmd.addOption(o));
 }
+/**
+ * Validate CLI options for contradictions and conflicts.
+ * Throws an error if conflicting options are detected.
+ */
+function validateCliOptions(opts, command) {
+    const errors = [];
+    // Cache conflicts
+    if (opts.cache && opts.noCache) {
+        errors.push({
+            flags: ["--cache", "--no-cache"],
+            message: "--cache and --no-cache are mutually exclusive",
+        });
+    }
+    // --force overrides --start-block (warn, not error)
+    if (opts.force && opts.startBlock) {
+        errors.push({
+            flags: ["--force", "--start-block"],
+            message: "--force resets discovery to block 0, overriding --start-block",
+        });
+    }
+    // Track command specific validations
+    if (command === "track") {
+        // --inspect and --inspect-only are mutually exclusive
+        if (opts.inspect && opts.inspectOnly) {
+            errors.push({
+                flags: ["--inspect", "--inspect-only"],
+                message: "--inspect and --inspect-only are mutually exclusive",
+            });
+        }
+        // --inspect-only skips tracking, so execution options don't make sense
+        if (opts.inspectOnly) {
+            const conflictingFlags = [];
+            if (opts.prepare)
+                conflictingFlags.push("--prepare");
+            if (opts.write)
+                conflictingFlags.push("--write");
+            if (opts.prepareCompleted)
+                conflictingFlags.push("--prepare-completed");
+            if (opts.preparePending)
+                conflictingFlags.push("--prepare-pending");
+            if (conflictingFlags.length > 0) {
+                errors.push({
+                    flags: ["--inspect-only", ...conflictingFlags],
+                    message: `--inspect-only skips tracking; ${conflictingFlags.join(", ")} require tracking`,
+                });
+            }
+        }
+    }
+    if (errors.length > 0) {
+        const messages = errors.map((e) => `  ${e.flags.join(" + ")}: ${e.message}`);
+        throw new Error(`Conflicting options detected:\n${messages.join("\n")}`);
+    }
+}
 /**
  * Parse gas settings from CLI options
  */
@@ -340,57 +398,114 @@ function formatTrackingResult(result, label) {
     }
     return lines.join("\n").concat("\n");
 }
-function formatCacheStatus(checkpoints) {
-    let proposalTotal = 0, proposalComplete = 0, proposalActive = 0, proposalFailed = 0;
-    let timelockTotal = 0, timelockComplete = 0, timelockActive = 0, timelockFailed = 0;
-    let electionTotal = 0, electionComplete = 0;
-    for (const [, checkpoint] of checkpoints) {
-        const stages = checkpoint.cachedData?.completedStages ?? [];
-        const isComplete = stages.length > 0 && (0, index_1.areAllStagesComplete)(stages);
-        const errorCount = checkpoint.metadata?.errorCount ?? 0;
-        const isFailed = errorCount >= exports.MAX_CONSECUTIVE_ERRORS;
-        const input = checkpoint.input;
-        if (input.type === "governor") {
-            if ((0, index_1.isElectionGovernor)(input.governorAddress)) {
-                electionTotal++;
-                if (isComplete)
-                    electionComplete++;
+function formatCacheStatus(checkpoints, elections) {
+    const stats = (0, index_1.computeCacheStats)(checkpoints, elections, exports.MAX_CONSECUTIVE_ERRORS);
+    const lines = [
+        `Total cached: ${stats.total}`,
+        ``,
+        `Proposals: ${stats.proposals.total}`,
+        `  Complete: ${stats.proposals.complete}`,
+        `  Active: ${stats.proposals.active}`,
+    ];
+    if (stats.proposals.errored > 0)
+        lines.push(`  Failed: ${stats.proposals.errored}`);
+    lines.push(``, `Timelock Ops: ${stats.timelocks.total}`, `  Complete: ${stats.timelocks.complete}`, `  Active: ${stats.timelocks.active}`);
+    if (stats.timelocks.errored > 0)
+        lines.push(`  Failed: ${stats.timelocks.errored}`);
+    if (stats.elections.total > 0) {
+        const active = stats.elections.total - stats.elections.complete;
+        lines.push(``, `Elections: ${stats.elections.total}`, `  Complete: ${stats.elections.complete}`, `  Active: ${active}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format an election status for CLI output
+ */
+function formatElectionResult(election) {
+    const lines = [];
+    const cohortName = election.cohort === 0 ? "First" : "Second";
+    const phaseName = election.phase.replace(/_/g, " ");
+    lines.push(`[Election #${election.electionIndex}]`);
+    lines.push(`Phase: ${phaseName}`);
+    lines.push(`Cohort: ${cohortName}`);
+    lines.push(`Complete: ${election.phase === "COMPLETED"}`);
+    lines.push(`Stages: ${election.stages?.length ?? 0}`);
+    lines.push("");
+    if (election.stages && election.stages.length > 0) {
+        for (let i = 0; i < election.stages.length; i++) {
+            const stage = election.stages[i];
+            const statusStr = stage.status;
+            const title = (0, index_1.formatStageTitle)(stage.type);
+            const eta = (0, index_1.calculateExpectedEta)(election.stages, i);
+            let line = `  ${title}: ${statusStr}`;
+            if (eta)
+                line += ` | ETA: ${new Date(eta * 1000).toISOString()}`;
+            lines.push(line);
+            for (const tx of stage.transactions) {
+                lines.push(`      tx: ${tx.hash}`);
+                const url = (0, index_1.getStageTransactionUrl)(tx);
+                if (url)
+                    lines.push(`        ${url}`);
             }
-            else {
-                proposalTotal++;
-                if (isComplete)
-                    proposalComplete++;
-                else if (isFailed)
-                    proposalFailed++;
-                else
-                    proposalActive++;
+        }
+    }
+    // Show timelock operation ID if tracked (useful for cross-referencing)
+    if (election.timelockOperationId) {
+        lines.push(`  Timelock Op: ${election.timelockOperationId}`);
+    }
+    if (election.canProceedToMemberPhase) {
+        lines.push("");
+        lines.push("  → Ready to trigger member election");
+    }
+    if (election.canExecuteMember) {
+        lines.push("");
+        lines.push("  → Ready to execute member election");
+    }
+    if (election.canCreateElection) {
+        lines.push("");
+        lines.push("  → Ready to create election");
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Display a tracking result, automatically switching to election display for election proposals.
+ * Handles the election auto-switch logic internally, falling back to formatTrackingResult for non-elections.
+ *
+ * @param result - Tracking result to display
+ * @param label - Optional label prefix
+ */
+function displayTrackingResult(result, label) {
+    if (result.isElection && result.electionStatus) {
+        const election = result.electionStatus;
+        const cohortName = election.cohort === 0 ? "First" : "Second";
+        console.log(`=== Election #${election.electionIndex} ===`);
+        console.log(`Phase: ${election.phase}`);
+        console.log(`Cohort: ${cohortName} (${election.cohort})`);
+        console.log(`Compliant Nominees: ${election.compliantNomineeCount}/${election.targetNomineeCount}`);
+        if (election.nomineeProposalId) {
+            console.log(`\nElection ID: ${election.nomineeProposalId}`);
+            console.log(`\nNominee Phase:`);
+            console.log(`  State: ${election.nomineeProposalState}`);
+            if (election.vettingDeadline) {
+                console.log(`  Vetting Deadline: block ${election.vettingDeadline}`);
             }
+            console.log(`  In Vetting Period: ${election.isInVettingPeriod ? "YES" : "NO"}`);
         }
-        else if (input.type === "timelock") {
-            timelockTotal++;
-            if (isComplete)
-                timelockComplete++;
-            else if (isFailed)
-                timelockFailed++;
-            else
-                timelockActive++;
+        if (election.memberProposalId) {
+            console.log(`\nMember Phase:`);
+            console.log(`  State: ${election.memberProposalState}`);
+        }
+        if (election.canProceedToMemberPhase) {
+            console.log(`\n→ Ready to trigger member election`);
+        }
+        if (election.canExecuteMember) {
+            console.log(`\n→ Ready to execute member election`);
         }
+        console.log("");
+        return;
     }
-    const lines = [
-        `Total cached: ${checkpoints.size}`,
-        ``,
-        `Proposals: ${proposalTotal}`,
-        `  Complete: ${proposalComplete}`,
-        `  Active: ${proposalActive}`,
-    ];
-    if (proposalFailed > 0)
-        lines.push(`  Failed: ${proposalFailed}`);
-    lines.push(``, `Timelock Ops: ${timelockTotal}`, `  Complete: ${timelockComplete}`, `  Active: ${timelockActive}`);
-    if (timelockFailed > 0)
-        lines.push(`  Failed: ${timelockFailed}`);
-    if (electionTotal > 0)
-        lines.push(``, `Elections: ${electionTotal} (${electionComplete} complete)`);
-    return lines.join("\n");
+    console.log(formatTrackingResult(result, label));
 }
 // ============================================================================
 // Loop Runner
@@ -549,27 +664,193 @@ function shortScope(key) {
     }
     return key;
 }
+/**
+ * Check if a checkpoint matches the enabled discovery targets.
+ * Used to filter incomplete checkpoints to only re-track types that are enabled.
+ */
+function checkpointMatchesTargets(checkpoint, targets) {
+    if (checkpoint.input.type === "governor") {
+        const governorAddress = checkpoint.input.governorAddress;
+        // Skip election governors - they're handled separately
+        if ((0, index_1.isElectionGovernor)(governorAddress))
+            return false;
+        // Check if constitutional or non-constitutional governor is enabled
+        const isCore = (0, index_1.isConstitutional)(governorAddress);
+        return isCore ? !!targets.constitutionalGovernor : !!targets.nonConstitutionalGovernor;
+    }
+    if (checkpoint.input.type === "timelock") {
+        // Timelock operations: check if the corresponding timelock target is enabled
+        const timelockAddress = checkpoint.input.timelockAddress;
+        const isCore = (0, index_1.isConstitutional)(timelockAddress);
+        return isCore ? !!targets.l2ConstitutionalTimelock : !!targets.l2NonConstitutionalTimelock;
+    }
+    if (checkpoint.input.type === "election") {
+        return !!targets.electionNomineeGovernor || !!targets.electionMemberGovernor;
+    }
+    // Discovery checkpoints don't need re-tracking
+    return false;
+}
+/**
+ * Filter checkpoints to only include those matching enabled discovery targets.
+ * Used for JSON output and stats to ensure we only show tracked types.
+ */
+function filterCheckpointsByTargets(checkpoints, targets) {
+    const filtered = new Map();
+    for (const [key, checkpoint] of checkpoints) {
+        if (checkpointMatchesTargets(checkpoint, targets)) {
+            filtered.set(key, checkpoint);
+        }
+    }
+    return filtered;
+}
+/**
+ * Calculate stats filtered by enabled discovery targets.
+ * Only counts checkpoints that match the enabled governors/timelocks.
+ */
+function calculateFilteredStats(checkpoints, targets, maxErrorCount = 5) {
+    let proposalTotal = 0, proposalComplete = 0, proposalActive = 0, proposalErrored = 0;
+    let timelockTotal = 0, timelockComplete = 0, timelockActive = 0, timelockErrored = 0;
+    let electionTotal = 0, electionComplete = 0;
+    for (const [, checkpoint] of checkpoints) {
+        const complete = (0, index_1.isCheckpointComplete)(checkpoint);
+        const errored = (0, index_1.isCheckpointErrored)(checkpoint, maxErrorCount);
+        const inputType = checkpoint.input.type;
+        if (inputType === "governor") {
+            const governorAddress = checkpoint.input.governorAddress;
+            if ((0, index_1.isElectionGovernor)(governorAddress))
+                continue;
+            const isCore = (0, index_1.isConstitutional)(governorAddress);
+            const matchesTarget = isCore
+                ? !!targets.constitutionalGovernor
+                : !!targets.nonConstitutionalGovernor;
+            if (!matchesTarget)
+                continue;
+            proposalTotal++;
+            if (complete)
+                proposalComplete++;
+            else if (errored)
+                proposalErrored++;
+            else
+                proposalActive++;
+        }
+        else if (inputType === "timelock") {
+            const timelockAddress = checkpoint.input.timelockAddress;
+            const isCore = (0, index_1.isConstitutional)(timelockAddress);
+            const matchesTarget = isCore
+                ? !!targets.l2ConstitutionalTimelock
+                : !!targets.l2NonConstitutionalTimelock;
+            if (!matchesTarget)
+                continue;
+            timelockTotal++;
+            if (complete)
+                timelockComplete++;
+            else if (errored)
+                timelockErrored++;
+            else
+                timelockActive++;
+        }
+        else if (inputType === "election") {
+            // Only count elections if election tracking is enabled
+            if (!targets.electionNomineeGovernor && !targets.electionMemberGovernor)
+                continue;
+            electionTotal++;
+            if (complete)
+                electionComplete++;
+        }
+    }
+    return {
+        total: proposalTotal + timelockTotal + electionTotal,
+        proposals: {
+            total: proposalTotal,
+            complete: proposalComplete,
+            active: proposalActive,
+            errored: proposalErrored,
+        },
+        timelocks: {
+            total: timelockTotal,
+            complete: timelockComplete,
+            active: timelockActive,
+            errored: timelockErrored,
+        },
+        elections: { total: electionTotal, complete: electionComplete },
+    };
+}
 async function runMonitorCycle(tracker, providers, options = {}) {
+    const result = { tracked: 0, prepared: 0, errors: 0, retracked: 0 };
+    // Fast path: elections-only mode skips discovery entirely
+    if (options.electionsOnly) {
+        const elections = [];
+        if (!isShuttingDown()) {
+            try {
+                // Use tracker's cached method - completed elections use cache (0 RPC calls)
+                // Use forceElections to bypass cache when --force is specified
+                const allElections = await tracker.trackAllElections({ force: options.forceElections });
+                for (const electionStatus of allElections) {
+                    elections.push(electionStatus);
+                    // Print each election
+                    console.log(formatElectionResult(electionStatus));
+                }
+            }
+            catch (err) {
+                console.error("Election tracking failed:", err);
+            }
+        }
+        return {
+            result,
+            proposals: [],
+            timelockOps: [],
+            watermarks: {},
+            elections,
+        };
+    }
     const l2Provider = providers.l2Provider;
     const tipBlock = await l2Provider.getBlockNumber();
     const blockLag = options.blockLag ?? exports.DEFAULT_BLOCK_LAG;
     const currentBlock = Math.max(0, tipBlock - blockLag);
     const concurrency = options.concurrency ?? 1;
     const limit = (0, concurrency_1.pLimit)(concurrency);
-    // Optional startBlock override (watermarks are exclusive, so subtract 1)
-    const startBlockWatermarks = options.startBlock
-        ? {
+    const maxAgeDays = options.maxAgeDays ?? exports.DEFAULT_MAX_AGE_DAYS;
+    // Calculate startBlock based on maxAgeDays if not explicitly provided
+    // ~7200 blocks per day on Arbitrum (12s block time on L1, ~250ms on L2)
+    const BLOCKS_PER_DAY = 86400 / 0.25; // ~345,600 blocks/day on Arbitrum One
+    let startBlockWatermarks;
+    // Load existing watermarks to determine scan range
+    const loadedWatermarks = await tracker.loadWatermarks();
+    const hasWatermarks = Object.values(loadedWatermarks.watermarks).some((v) => v !== undefined);
+    if (options.startBlock !== undefined) {
+        // Explicit startBlock override (watermarks are exclusive, so subtract 1)
+        startBlockWatermarks = {
             constitutionalGovernor: options.startBlock - 1,
             nonConstitutionalGovernor: options.startBlock - 1,
             electionNomineeGovernor: options.startBlock - 1,
             electionMemberGovernor: options.startBlock - 1,
             l2ConstitutionalTimelock: options.startBlock - 1,
             l2NonConstitutionalTimelock: options.startBlock - 1,
-        }
-        : undefined;
-    const targets = (0, index_1.buildDefaultTargets)();
+        };
+        console.log(`Discovery: blocks ${options.startBlock} → ${currentBlock}`);
+    }
+    else if (!hasWatermarks) {
+        // No cache - calculate start block from maxAgeDays
+        const defaultStartBlock = Math.max(0, currentBlock - Math.floor(maxAgeDays * BLOCKS_PER_DAY));
+        startBlockWatermarks = {
+            constitutionalGovernor: defaultStartBlock,
+            nonConstitutionalGovernor: defaultStartBlock,
+            electionNomineeGovernor: defaultStartBlock,
+            electionMemberGovernor: defaultStartBlock,
+            l2ConstitutionalTimelock: defaultStartBlock,
+            l2NonConstitutionalTimelock: defaultStartBlock,
+        };
+        console.log(`No cached watermarks. Discovery: blocks ${defaultStartBlock} → ${currentBlock} (~${maxAgeDays} days)`);
+    }
+    else {
+        // Cached watermarks exist - calculate effective range from min watermark
+        const watermarkBlocks = Object.values(loadedWatermarks.watermarks).filter((v) => v !== undefined);
+        const minWatermark = Math.min(...watermarkBlocks);
+        const blockRange = currentBlock - minWatermark;
+        console.log(`Discovery: blocks ${minWatermark} → ${currentBlock} (${blockRange.toLocaleString()} blocks)`);
+    }
+    const targets = options.targets ?? (0, index_1.buildDefaultTargets)();
     const discoveryResult = await tracker.discoverAll(targets, currentBlock, startBlockWatermarks);
-    const result = { tracked: 0, prepared: 0, errors: 0, retracked: 0 };
     const trackedKeys = new Set();
     const trackedOperationIds = new Set();
     async function track(key, trackFn) {
@@ -623,7 +904,6 @@ async function runMonitorCycle(tracker, providers, options = {}) {
         });
     }
     // Query incomplete checkpoints first to avoid duplicate tracking
-    const maxAgeDays = options.maxAgeDays ?? exports.DEFAULT_MAX_AGE_DAYS;
     const incompleteCheckpoints = await tracker.queryIncompleteCheckpoints({
         maxAgeDays,
         maxErrorCount: exports.MAX_CONSECUTIVE_ERRORS,
@@ -654,14 +934,10 @@ async function runMonitorCycle(tracker, providers, options = {}) {
             },
         });
     }
-    // 1b. Incomplete governor checkpoints to re-track (excluding elections)
-    const nonElectionCheckpoints = incompleteCheckpoints.filter(({ checkpoint }) => {
-        if (checkpoint.input.type === "governor")
-            return !(0, index_1.isElectionGovernor)(checkpoint.input.governorAddress);
-        return true;
-    });
-    result.retracked = nonElectionCheckpoints.length;
-    for (const { key, checkpoint } of nonElectionCheckpoints) {
+    // 1b. Incomplete checkpoints to re-track (filtered by enabled targets)
+    const targetMatchingCheckpoints = incompleteCheckpoints.filter(({ checkpoint }) => checkpointMatchesTargets(checkpoint, targets));
+    result.retracked = targetMatchingCheckpoints.length;
+    for (const { key, checkpoint } of targetMatchingCheckpoints) {
         if (checkpoint.input.type === "governor") {
             proposalTasks.push({
                 key,
@@ -699,7 +975,7 @@ async function runMonitorCycle(tracker, providers, options = {}) {
         });
     }
     // 2b. Incomplete timelock checkpoints to re-track
-    for (const { key, checkpoint } of nonElectionCheckpoints) {
+    for (const { key, checkpoint } of targetMatchingCheckpoints) {
         if (checkpoint.input.type === "timelock") {
             const operationId = checkpoint.input.operationId;
             // Skip if already tracked via proposal
@@ -715,11 +991,28 @@ async function runMonitorCycle(tracker, providers, options = {}) {
     }
     // Run timelock tasks
     await Promise.all(timelockTasks.map((task) => limit(() => track(task.key, task.fn))));
+    // Phase 3: Track elections (only if election targets are enabled)
+    const elections = [];
+    const shouldTrackElections = targets.electionNomineeGovernor || targets.electionMemberGovernor;
+    if (shouldTrackElections && !isShuttingDown()) {
+        try {
+            // Use tracker's cached method - completed elections use cache (0 RPC calls)
+            const allElections = await tracker.trackAllElections({ force: options.forceElections });
+            for (const electionStatus of allElections) {
+                elections.push(electionStatus);
+            }
+        }
+        catch (err) {
+            // Election tracking is non-critical, log and continue
+            console.error("Election tracking failed:", err);
+        }
+    }
     return {
         result,
         proposals: discoveryResult.proposals,
         timelockOps: discoveryResult.timelockOps,
         watermarks: discoveryResult.watermarks,
+        elections,
     };
 }
 // ============================================================================