SPEC FOLD / CHANGE REVIEW

Northstar sample contract review (fictional)

Project: Northstar Workshop API (fictional sample) · Base: 1.0.0 · fictional base · Target: 1.1.0 candidate · fictional target

Findings: 14 · Breaking-candidates: 3 · Review-needed: 6 · Additions: 5

This heuristic review is not a compatibility, security, compliance, or release verdict.

SeverityFinding / evidence
breaking-candidateOperation removed: DELETE /v1/workshops/{workshopId}

An operation in the base snapshot is absent from the target. Clients may depend on it; assess before release.

deferred · R. Sample (fictional)

Note: Compare the old mobile-client fixture before deciding whether this operation can be retired.

breaking-candidateParameter now required: GET /v1/workshops · query season

An optional parameter became required; existing clients may omit it.

in_review · M. Example (fictional)

Note: Check whether the seasonal import job supplies this value; the sample contract test is still pending.

breaking-candidateRequest property now required: POST /v1/workshops · room

Required membership was tightened; existing payloads/consumers may be affected.

open · unassigned
review-neededOperation description changed: GET /v1/workshops

Review the wording for contract or behavioral implications.

open · unassigned
review-neededOperation security changed: POST /v1/workshops

Security requirements differ. This tool does not assess security correctness or effective inherited security.

open · unassigned
review-neededRequest body changed: POST /v1/workshops

Request-body structure or media type differs; inspect exact payload schemas and requiredness.

open · unassigned
review-neededResponse property now required: GET /v1/workshops/{workshopId} · 200 · room

Required membership was tightened; existing payloads/consumers may be affected.

open · unassigned
review-neededResponse property now required: POST /v1/workshops · 201 · startsAt

Required membership was tightened; existing payloads/consumers may be affected.

open · unassigned
review-neededResponse removed: POST /v1/workshops · 400

A declared response code was removed. Confirm dependent client handling and server behavior.

open · unassigned
additionOperation added: PATCH /v1/workshops/{workshopId}

A new operation exists in the target snapshot. Confirm intended exposure, authorization, and client expectations.

open · unassigned
additionRequest property added: POST /v1/workshops · room

A property was added. Additive for many consumers, but verify generated clients and strict payload handling.

open · unassigned
additionResponse added: POST /v1/workshops · 409

A response code was added. Check client handling and actual response behavior.

open · unassigned
additionResponse property added: GET /v1/workshops/{workshopId} · 200 · capacity

A property was added. Additive for many consumers, but verify generated clients and strict payload handling.

accepted · A. Example (fictional)

Note: Accept for the sample documentation; this does not establish that real clients ignore unknown fields.

additionResponse property added: POST /v1/workshops · 201 · startsAt

A property was added. Additive for many consumers, but verify generated clients and strict payload handling.

open · unassigned