Parse Map
Preserve source values and produce traceable candidates.
Follow ../../references/interaction-contract.md.
Process
- Identify CSV, JSON, XML, XLSX, or structured-text input.
- Read
references/format-support.md when the shape is unclear.
- Run
python3 <skill-dir>/scripts/run.py --input <path> --output <path>.
- Validate the whole parse, then summarize rejected rows, assumptions, warnings, and
holds by cause instead of presenting rows one at a time.
Output files
- The requested output JSON - Use this candidate map as the input to normalization. It preserves source values and lists rejected rows and parse warnings. It is not yet an approved map.
Completion requires a schema-valid candidate map and parse report. Engineering fields can remain unresolved.
Stop
- Stop if the source is a PDF manual; that is
extract-pdf-map or compile-user-map.
- Stop for writes, broadcasts, discovery, or unbounded polling.
- Do not approve address, area, unit, datatype, access, or byte order.
Handoff
- The user wants an organized user map, JSON, CSV, or tool outputs from this OEM source: suggest
compile-user-map.
- Candidate rows exist and the user asked only for this stage: suggest
normalize-map.
- The source is a PDF manual: suggest
extract-pdf-map.
Parsing preserves uncertainty. It does not approve address, area, unit, datatype, access, or byte order.
1---2name: parse-map3description: Parse structured Modbus register maps into candidate rows with source values, rejected rows, assumptions, and holds. Use when the source is CSV, JSON, XML, XLSX, or structured text and needs traceable candidate rows.4license: Apache-2.05---67# Parse Map89Preserve source values and produce traceable candidates.1011Follow `../../references/interaction-contract.md`.1213## Process14151. Identify CSV, JSON, XML, XLSX, or structured-text input.162. Read `references/format-support.md` when the shape is unclear.173. Run `python3 <skill-dir>/scripts/run.py --input <path> --output <path>`.184. Validate the whole parse, then summarize rejected rows, assumptions, warnings, and19 holds by cause instead of presenting rows one at a time.2021## Output files2223- The requested output JSON - Use this candidate map as the input to normalization. It preserves source values and lists rejected rows and parse warnings. It is not yet an approved map.2425Completion requires a schema-valid candidate map and parse report. Engineering fields can remain unresolved.2627## Stop2829- Stop if the source is a PDF manual; that is `extract-pdf-map` or `compile-user-map`.30- Stop for writes, broadcasts, discovery, or unbounded polling.31- Do not approve address, area, unit, datatype, access, or byte order.3233## Handoff3435- The user wants an organized user map, JSON, CSV, or tool outputs from this OEM source: suggest `compile-user-map`.36- Candidate rows exist and the user asked only for this stage: suggest `normalize-map`.37- The source is a PDF manual: suggest `extract-pdf-map`.3839Parsing preserves uncertainty. It does not approve address, area, unit, datatype, access, or byte order.
studioxvii