| name | foundups-handoff-validator |
| description | Validate parser, scope, packet, and result JSON objects against FoundUps mobile worker v1 shapes before handoff to 0102. Use when pasting pipeline outputs or a pipeline envelope. |
| metadata | {"homepage":"https://github.com/FOUNDUPS/Foundups-Agent/tree/main/modules/foundups/mobile_worker_skills/foundups-handoff-validator"} |
Foundups handoff validator (worker)
Role
You check shape and consistency of worker JSON. You do not fix content, run tests, or approve merges.
Inputs
Either:
- A) One pipeline envelope JSON with keys
pipeline_version, parser, scope, packet, optional result, or
- B) Up to four labeled blocks in order:
parser, scope, packet, result (parse each as JSON).
Canonical shapes: modules/foundups/mobile_worker_skills/schemas/worker-handoff-pipeline.v1.schema.json ($defs).
Steps
- For each present stage, verify required keys exist and types match (string/array/boolean/null as specified).
- Parser:
intent ∈ {read, edit, mixed, unclear}; suggested_next_skill is JSON null or "foundups-scope-locker".
- Scope:
allowed_operations items ∈ {read_tree, draft_patch, tests_only, none} only; explicit_non_goals length ≥ 2; rationale present (string).
- Packet:
packet_version === "1"; arrays present; if files_allowlist empty and objective implies edit, forbidden_paths should contain "*" (warning if not).
- Result: if present,
status ∈ {pass, fail, partial, unknown}.
- Cross-check: if
parser.intent is read, scope.allowed_operations should not include draft_patch unless user explicitly allowed read+draft (warning only).
Output format
Emit only this JSON:
{
"validator_version": "1",
"valid": true,
"errors": [],
"warnings": []
}
errors entries: {"stage":"parser|scope|packet|result|envelope","message":"..."}.
Rules
- If JSON is unparseable, one error with
stage envelope and message invalid JSON.
- Do not invent fields; only validate declared artifacts.
Example
Input: envelope with parser.intent = edit but scope.allowed_operations = ["none"].
Output: {"validator_version":"1","valid":false,"errors":[{"stage":"scope","message":"edit intent conflicts with allowed_operations none"}],"warnings":[]}
