Calendar Hold Sync

Implement hold mirroring from source Google calendars into target calendars to prevent double-booking.

Dependency

• - Require gog CLI in PATH.
• Require user OAuth already configured for each account used in mappings.
• Do not hardcode account emails, calendar IDs, or event IDs in code.

If gog is not configured, use this setup flow:

1. 1. Run gog auth credentials /path/to/client_secret.json.
2. Run gog auth add you@gmail.com --services calendar.
3. Verify with gog auth list.

Only add additional Google services if you explicitly need them for another workflow.

Official gog references:

• - Homepage: https://gogcli.sh/
• Source: https://github.com/steipete/gogcli

Config Contract

Use a user-provided JSON config file with this shape:

• - INLINECODE8
• INLINECODE9
• INLINECODE10
• INLINECODE11 (default primary)
• INLINECODE13 with INLINECODE14
• INLINECODE15 (default 30)
• INLINECODE17: INLINECODE18
• INLINECODE19: INLINECODE20
• INLINECODE21 (default Busy)
• INLINECODE23 (private)
• INLINECODE25 (busy)
• INLINECODE27 (none)
• INLINECODE29 (none)
• INLINECODE31 (SYNCV1)
• INLINECODE33 (base64url(json))
• INLINECODE35: INLINECODE36
• INLINECODE37
• INLINECODE38 (optional)
• INLINECODE39 (optional)
• INLINECODE40 (optional, default 20)
• INLINECODE42
• INLINECODE43
• INLINECODE44
• INLINECODE45
• INLINECODE46 (optional template overrides)
• INLINECODE47 (must be true to enable any gog.*Cmd override)

Custom Command Template Safety

When custom commands are enabled:

• - Only gog command templates are accepted.
• Templates are rendered by replacing placeholders like {account} and {calendarId}.
• Rendered commands are executed as argv tokens (no shell interpolation).
• Keep gog.allowCustomCommands=false unless you fully trust and audit the config file.

Metadata Encoding

Store source linkage in hold description as:

• - INLINECODE55

JSON fields:

• - INLINECODE56
• INLINECODE57
• INLINECODE58
• INLINECODE59
• INLINECODE60
• INLINECODE61

Behavior

For each mapping:

1. 1. Read source events in the active window.
2. Build desired hold events (private, busy, no reminders).
3. Detect existing managed holds by SYNCV1: prefix.
4. Reconcile idempotently:

• - Create missing holds.
• Update drifted holds.
• Delete stale holds.

1. 5. If overlap policy is skip, do not create a hold when a non-managed target event overlaps.
2. Enforce maxChangesPerRun.
3. Respect dryRun.

Backfill

Backfill mode upgrades legacy hold events (matching expected hold signature but lacking SYNCV1) by attaching encoded metadata when a unique source match exists.

Command Surface

• - INLINECODE69
• INLINECODE70
• INLINECODE71
• INLINECODE72
• INLINECODE73
• INLINECODE74

Watch Cadence

Require watch cadence to be configurable from user config:

• - scheduling.watchIntervalSeconds controls watch poll frequency.
• INLINECODE76 controls rolling watch/reconcile window.

Recommend baseline values:

• - watchIntervalSeconds: 900 (15 minutes)
• INLINECODE78 (24 hours)

Working Model

• - Use polling-based watch mode (hold-sync watch) for fast updates.
• Expect update latency approximately equal to watchIntervalSeconds.
• Treat this as self-hosted/operator-run automation.

Known Limits

• - Do not assume webhook/push subscriptions are present; current fast sync path is polling.
• Keep periodic scheduled reconcile as fallback even when watch mode is enabled.

Required Tests

• - metadata encode/decode round-trip
• overlap detection correctness
• idempotent reconcile upsert/delete behavior

Attribution: gog setup flow adapted from:

• - https://clawhub.ai/steipete/gog
• https://github.com/steipete/gogcli
• https://gogcli.sh/

Provider Notes (openclaw)

Use this variant when publishing to ClawHub/OpenClaw.

• - Keep instructions implementation-focused and command-oriented.
• Keep dependency explicit: gog must be preconfigured by user.
• Prefer deterministic script execution over speculative edits.
• Avoid provider-specific APIs; treat the CLI as the boundary.