Class RuleRegistrar

Manages virtual rule registration with watcher.

Registers at startup with exponential retry
Tracks watcher uptime for restart detection
Re-registers opportunistically when uptime decreases

Index

Constructors

Accessors

Methods

checkAndReregister register

Constructors

constructor

new RuleRegistrar(
    config: {
        architectEvery: number;
        architectTimeout: number;
        builderTimeout: number;
        criticTimeout: number;
        defaultArchitect?: string;
        defaultCritic?: string;
        depthWeight: number;
        gatewayApiKey?: string;
        gatewayUrl: string;
        maxArchive: number;
        maxLines: number;
        metaArchiveProperty: Record<string, unknown>;
        metaProperty: Record<string, unknown>;
        skipUnchanged: boolean;
        thinking: string;
        watcherUrl: string;
    },
    logger: Logger,
    watcher: WatcherClient,
): RuleRegistrar
Parameters
- config: {
      architectEvery: number;
      architectTimeout: number;
      builderTimeout: number;
      criticTimeout: number;
      defaultArchitect?: string;
      defaultCritic?: string;
      depthWeight: number;
      gatewayApiKey?: string;
      gatewayUrl: string;
      maxArchive: number;
      maxLines: number;
      metaArchiveProperty: Record<string, unknown>;
      metaProperty: Record<string, unknown>;
      skipUnchanged: boolean;
      thinking: string;
      watcherUrl: string;
  }
  - architectEvery: number
    Run architect every N cycles (per meta).
  - architectTimeout: number
    Architect subprocess timeout in seconds.
  - builderTimeout: number
    Builder subprocess timeout in seconds.
  - criticTimeout: number
    Critic subprocess timeout in seconds.
  - OptionaldefaultArchitect?: string
    Resolved architect system prompt text. Falls back to built-in default.
  - OptionaldefaultCritic?: string
    Resolved critic system prompt text. Falls back to built-in default.
  - depthWeight: number
    Exponent for depth weighting in staleness formula.
  - OptionalgatewayApiKey?: string
    Optional API key for gateway authentication.
  - gatewayUrl: string
    OpenClaw gateway base URL for subprocess spawning.
  - maxArchive: number
    Maximum archive snapshots to retain per meta.
  - maxLines: number
    Maximum lines of context to include in subprocess prompts.
  - metaArchiveProperty: Record<string, unknown>
    Watcher metadata properties applied to archive snapshots.
  - metaProperty: Record<string, unknown>
    Watcher metadata properties applied to live .meta/meta.json files.
  - skipUnchanged: boolean
    Skip unchanged candidates, bump _generatedAt.
  - thinking: string
    Thinking level for spawned synthesis sessions.
  - watcherUrl: string
    Watcher service base URL.
- logger: Logger
- watcher: WatcherClient
Returns RuleRegistrar
- Defined in packages/service/src/rules/index.ts:197

Accessors

isRegistered

get isRegistered(): boolean
Whether rules have been successfully registered.

Returns boolean
- Defined in packages/service/src/rules/index.ts:208

Methods

checkAndReregister

checkAndReregister(currentUptime: number): Promise<void>
Check watcher uptime and re-register if it decreased (restart detected).
Parameters
- currentUptime: number
  Current watcher uptime in seconds.
Returns Promise<void>
- Defined in packages/service/src/rules/index.ts:245

register

register(): Promise<void>
Register rules with watcher. Retries with exponential backoff. Non-blocking — logs errors but never throws.

Returns Promise<void>
- Defined in packages/service/src/rules/index.ts:216