ruvnet/ruflo · error

Witness chain gap on ${deviceId}: epoch ${fromEpoch} → ${toE

Error message

Witness chain gap on ${deviceId}: epoch ${fromEpoch} → ${toEpoch}

What it means

Warning raised by a witness-chain audit worker during initialize(): the chain of witness attestations for a device is missing entries between fromEpoch and toEpoch, meaning tamper-evidence for that epoch range is incomplete.

Source

Thrown at v3/@claude-flow/plugin-iot-cognitum/src/plugin.ts:134

    const firmwareWatchIntervalMs = (config['firmwareWatchIntervalMs'] as number) ?? 300_000;
    this.firmwareWatch = new FirmwareWatchWorker(this.coordinator, {
      intervalMs: firmwareWatchIntervalMs,
      onVersionMismatch: (deviceId, expected, actual) => {
        context.logger.warn(`Firmware mismatch on ${deviceId}: expected ${expected}, got ${actual}`);
        context.eventBus.emit('iot:firmware-mismatch', { deviceId, expected, actual });
      },
      onWatchError: (deviceId, error) => {
        context.logger.warn(`Firmware watch error for ${deviceId}: ${error.message}`);
      },
    });
    this.firmwareWatch.start();

    const witnessAuditIntervalMs = (config['witnessAuditIntervalMs'] as number) ?? 600_000;
    this.witnessAudit = new WitnessAuditWorker(this.coordinator, {
      intervalMs: witnessAuditIntervalMs,
      onGapDetected: (deviceId, fromEpoch, toEpoch) => {
        context.logger.warn(`Witness chain gap on ${deviceId}: epoch ${fromEpoch} → ${toEpoch}`);
        context.eventBus.emit('iot:witness-gap', { deviceId, fromEpoch, toEpoch });
      },
      onAuditError: (deviceId, error) => {
        context.logger.warn(`Witness audit error for ${deviceId}: ${error.message}`);
      },
    });
    this.witnessAudit.start();

    context.logger.info('IoT Cognitum plugin initialized');
  }

  async shutdown(): Promise<void> {
    if (this.witnessAudit) {
      this.witnessAudit.stop();
      this.witnessAudit = null;
    }
    if (this.firmwareWatch) {
      this.firmwareWatch.stop();

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Investigate the witness chain gap on the named device; missing epochs indicate downtime or tampering — re-sync the witness log.

When it happens

Trigger: Thrown at v3/@claude-flow/plugin-iot-cognitum/src/plugin.ts:134 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/a85cf120b4db8bcd. Report an issue: GitHub.