# GEOmend

> Combine GEO and local metadata, inspect column suggestions, and export tables with their evidence.

## Discover and choose a workflow

- Capabilities: `geomend capabilities --json` (offline; use advertised schemas and operations).
- Documentation and task chooser: https://prestonraab.github.io/geomend/
- Project tutorial: https://prestonraab.github.io/geomend/project/
- Project: `geomend project create SOURCE... --project PROJECT`.
- Initial table: `geomend project exports table PROJECT --mode best_guess --profile analysis --output metadata.tsv` (may include unreviewed mappings).
- Reviewed project table: use `--mode reviewed`; sample rows remain when reviewed values are blank.
- Fixed reconciliation: `geomend reconcile plan SOURCE... --output-dir PLAN`, resolve blockers/prerequisites, then run the reported command.

## Inspect, decide, and export

- Candidates: `geomend project mappings candidates PROJECT --field FIELD_ID --json`; preview and select with revision and pool-hash tickets.
- Review protocol: https://prestonraab.github.io/geomend/reviewer-protocol/
- Packet queue: `geomend review queue PACKET --json`; compact case: `geomend review model PACKET P1 --json`.
- Preview: `geomend review preview PACKET P1 --accept A1 --json`.
- Save: `geomend review decide PACKET P1 --accept A1 --rationale RATIONALE --json`; use `--nomatch` or `--defer` when supported by evidence.
- Return the complete `.geomend-response.zip`; retain its original evidence packet. The coordinator imports it.
- Reviewed data/audits: https://prestonraab.github.io/geomend/native-review-export/
- Client contract: https://prestonraab.github.io/geomend/reviewer-client-contract/
- Preserve source metadata and review records. Use CLI, SDK, or authenticated API; never write SQLite or response records directly.
