Trigger Schema Package

This package bundles the versioned Zod schema used for Trigger configuration files (e.g. .qckfx/triggers/*.json). It mirrors the layout & approach used by the agent schema package so maintainers can follow the same workflow.

Version folders

• src/v1/ – schema version 1.0 (current latest).

Each version folder contains:

1. trigger.ts – Zod schema exported as TriggerSchemaV1 plus its TypeScript type TriggerV1.
2. migrate.ts (optional) – functions that upgrade the parsed object to the latest canonical representation. For v1 it is an identity function.

Registry & helpers

src/index.ts maintains a registry mapping version string → { schema, upgrade fn }. The helper parseTriggerConfig():

1. Extracts the version from the config’s $schema URL or string.
2. Removes $schema (root schemas are strict).
3. Validates via the correct Zod schema.
4. Applies the upgrade function so callers always receive the latest structure.

Adding a new version

1. Create src/vX.Y/trigger.ts with the updated Zod schema.
2. Provide upgradeVXYToLatest() migration.
3. Register it in src/index.ts and bump SCHEMA_VERSION_LATEST plus the exported Trigger type alias.
4. Add unit tests.

That’s it – the server code keeps using parseTriggerConfig() or (for backward compat) TriggerSchema.parse().