Shuffle JSON Data

Overview

Role

• Confirm that every object shares the same property names when the default behavior targets each object.
• Reject or escalate when the structure prevents a safe shuffle (for example, nested objects while operating in the default state).
• Shuffle data only after validation succeeds or after reading explicit variable overrides.

Objectives

1. Validate that the provided JSON is structurally consistent and can be shuffled without producing invalid output.
2. Apply the default behavior—shuffle at the object level—when no variables appear under the

   Variables

   header.
3. Honour variable overrides that adjust which collections are shuffled, which properties are required, or which properties must be ignored.

Data Validation Checklist

• Ensure every object shares an identical set of property names when the default state is in effect.
• Confirm there are no nested objects in the default state.
• Verify that the JSON file itself is syntactically valid and well formed.
• If any check fails, stop and report the inconsistency instead of modifying the data.

Acceptable JSON

[
  {
    "VALID_PROPERTY_NAME-a": "value",
    "VALID_PROPERTY_NAME-b": "value"
  },
  {
    "VALID_PROPERTY_NAME-a": "value",
    "VALID_PROPERTY_NAME-b": "value"
  }
]

Unacceptable JSON (Default State)

[
  {
    "VALID_PROPERTY_NAME-a": {
      "VALID_PROPERTY_NAME-a": "value",
      "VALID_PROPERTY_NAME-b": "value"
    },
    "VALID_PROPERTY_NAME-b": "value"
  },
  {
    "VALID_PROPERTY_NAME-a": "value",
    "VALID_PROPERTY_NAME-b": "value",
    "VALID_PROPERTY_NAME-c": "value"
  }
]

Workflow

1. Gather Input – Confirm that a JSON file or JSON-like structure is attached. If not, pause and request the data file.
2. Review Configuration – Merge defaults with any supplied variables under the

   Variables

   header or prompt-level overrides.
3. Validate Structure – Apply the Data Validation Checklist to confirm that shuffling is safe in the selected mode.
4. Shuffle Data – Randomize the collection(s) described by the variables or the default behavior while maintaining JSON validity.
5. Return Results – Output the shuffled data, preserving the original encoding and formatting conventions.

Requirements for Shuffling Data

• Each request must provide a JSON file or a compatible JSON structure.
• If the data cannot remain valid after a shuffle, stop and report the inconsistency.
• Observe the default state when no overrides are supplied.

Examples

Missing File

[user]
> /shuffle-json-data
[agent]
> Please provide a JSON file to shuffle. Preferably as chat variable or attached context.

Custom Configuration

[user]
> /shuffle-json-data #file:funFacts.json ignoreProperties = "year", "category"; requiredProperties = "fact"

Default State

• fileName = REQUIRED
• ignoreProperties = none
• requiredProperties = first set of properties from the first object
• nesting = false

Variables

• ignoreProperties
• requiredProperties
• nesting