Step 1: Establish baseline vs upstream

[Sam-Bolling]

Goal

Establish a precise, reproducible baseline between this fork and upstream so every later review step has a verified change context.

Scope

• Confirm upstream source and base branch.
• Identify fork-only commits, files, and high‑churn hotspots.
• Record a stable reference point for future diffs.

Tasks

1. Verify upstream

• Confirm upstream repo: camptocamp/ogc-client (or update if different).
• Record upstream default branch name and HEAD commit.

2. Add/refresh upstream remote

• git remote add upstream https://github.com/camptocamp/ogc-client.git (or verify existing).
• git fetch upstream --tags.

3. Establish merge base

• Determine common ancestor between fork main and upstream main.
• Record base commit SHA and date.

4. Fork-only commit list

• Produce fork‑only commits: git log --oneline upstream/main..main.
• Categorize commits by area (API, parsers, validators, tests, tooling).

5. Fork-only files and hotspots

• List files changed since merge base.
• Identify top directories by churn (e.g., src/ogc-api/csapi, tests, build configs).
• Flag new files not present upstream.

6. Risk flags

• Note any likely breaking changes (public exports, config, build/test infra).
• Identify any deleted tests or significant refactors.

7. Deliverable summary
   Provide a short report with:

• Upstream reference info
• Merge base SHA
• Fork‑only commit list
• Hotspot files/directories
• Risk flags

Acceptance Criteria

• Upstream remote verified and fetch successful.
• Merge base identified and recorded.
• Fork‑only commits and files summarized.
• Hotspots and risks identified with a concise summary.

Output Format (suggested)

• Upstream: org/repo, branch, HEAD SHA
• Merge base: SHA + date
• Fork‑only commits: list (grouped)
• Hotspots: top dirs/files by churn
• Risk flags: bullets

Notes

Keep the report short and factual; no remediation yet. That begins in Step 2+.

[Sam-Bolling]

Step 1 completed. Baseline vs upstream established.

Upstream

• Repo: camptocamp/ogc-client
• Branch: upstream/main
• HEAD: 53a6449 (2025-12-17 11:01:42 +0100) “Merge pull request fix: parse WMS bounding boxes as numbers instead of strings camptocamp/ogc-client#132 from camptocamp/fix-bbox”

Merge base

• merge-base(upstream/main, main) = 53a6449 (same as upstream HEAD)

Fork-only commits

• Count: 69 commits ahead of upstream/main
• List: git log --oneline upstream/main..main (see local output for full list)

Fork-only files / change summary

• Files changed: 100
• Diff stats: 45,188 insertions / 168 deletions
• High-level changes include: new CSAPI implementation, SWE Common types/validators, SensorML models, parsers, validators, request builders, typed navigator, fixtures, OpenAPI specs, tests, and tooling/config adjustments.

Hotspot directories (by churn)

• src/ogc-api/csapi/sensorml/ (15%)
• src/ogc-api/csapi/validation/ (12%)
• src/ogc-api/csapi/ (10%)
• src/ogc-api/csapi/parsers/ (8%)
• src/ogc-api/csapi/geojson/features/ (8%)
• src/ogc-api/csapi/swe-common/ (8%)
• src/ogc-api/csapi/swe-common/types/ (7%)

Risk flags / notes

• CI workflows removed: .github/workflows/gh-pages.yml, publish.yml, qa.yml.
• Large spec additions: spec/ogcapi-connectedsystems-* bundled OAS files.
• swe-validator.spec.ts shows 0 lines in diff stat (verify intended state).
• Formatting/config changes (.prettierrc.json, .prettierignore, eslint.config.js, line endings).

This completes Step 1 baseline discovery. Ready for Step 2 (dependency/build integrity review).