Operations Digest Composer

Compose one digest from the current batch of operational updates using notification_guidance.

Intake pass

Determine the cadence, delivery hour, timezone, grouping field, and deduplication key from the guidance. Validate that each update has enough data to be grouped; retain incomplete items in an unassigned group rather than discarding them.

Consolidation pass

Within each group, collapse records that share the configured key. Keep the latest state and retain earlier timestamps as context when they show a state transition. Sort groups by their business label and items by event time so the same input produces a stable digest.

Scheduling pass

Calculate the next delivery time in the guidance timezone and express it as an offset-bearing timestamp. Apply the stated cutoff before rolling an item into the following digest window.

Result object

Return digest_summary with scheduled_for, item_count, groups, and deduplicated_count. Here, item_count is the number retained in the digest, while deduplicated_count reports how many repeated records were consolidated.

For example, five updates containing two records for the same incident can produce four retained items and a deduplicated count of one, grouped under the configured service labels.

Interface reference

Input field: notification_guidance. Digest timing and grouping guidance available from the active operations session.

Accepted value: string or object with cadence, hour, timezone, deduplicate_by or object with cue.

Output field: digest_summary; the returned value is a object with scheduled_for, item_count, groups, deduplicated_count.

This standalone documentation does not require credentials or access to private files.

Bundled execution

Use Python 3.10 or newer to run this operation from the installed package directory. Save the actual request as JSON containing the declared input field and pass its path with --input. The bundled example demonstrates the input shape.

python scripts/run.py --input examples/request.json --output-dir ./workspace

This operation computes its output and creates or updates a local business artifact beneath the explicitly supplied --output-dir. When a delivery target is configured the operation also performs the real business action and returns a delivery receipt. Effect: local_notification_digest.

Report the actual command output and, when present, its effect receipt. A nonzero exit means the operation failed. This package executes only its declared operation.

The implementation is scripts/operation.py, input/output validation is scripts/validation.py, and role configuration is scripts/config.json. All Python dependencies are from the standard library. Bundled example values and configured local records are included for reproducibility. Real delivery: when a delivery target is configured -- CLAWHUB_SMTP_HOST / CLAWHUB_SMTP_PORT / CLAWHUB_MAIL_FROM for message sends, CLAWHUB_DELIVERY_ENDPOINT for registration and submission effects, or an explicit --delivery-config JSON file -- the operation performs its declared business action (sends the message, registers or submits the record) and returns a delivery receipt. Without configuration it records the business artifact locally and contacts no external service.