Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 0 additions & 22 deletions .spectral.yaml

This file was deleted.

8 changes: 4 additions & 4 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,6 @@ here automatically by the producer's CI; do not hand-edit the spec.
- `spec/provenance.json` - the last publish's deploy `sequence`/`sha`/`tag`; the ordering guard drops
publishes from an older deploy than this. Generated on publish; do not hand-edit.
- `CHANGELOG.md` - generated diff between releases.
- `.spectral.yaml` - shared lint ruleset.
- `scripts/publish.ts` - change-detect + ordering guard, commits latest + cuts a release; invoked by
the producer's CI as `npm run publish:spec` after a production deploy.
- `scripts/release-tag.ts` - computes the provenance tag; pure, unit-tested.
Expand All @@ -34,11 +33,12 @@ Two separate concepts. `info.version` inside the spec is a curated human label.

## Gates / commands

- `npm install` - install the dev toolchain (tsx, typescript, spectral).
- `npm install` - install the dev toolchain (tsx, typescript).
- `npm run typecheck` - strict type-check (`tsc --noEmit`).
- `npm test` - run the unit tests (`tsx --test`).
- `npm run lint:spec -- <file>` - lint a spec against `.spectral.yaml` (errors fail; the ruleset,
engine, and severity are single-sourced here). E.g. `npm run lint:spec -- spec/openapi.json`.

Spec linting lives with the producer (platform-api), which owns the ruleset and enforces it pre-merge;
this repo holds only the published artifact and the publish logic.

## Conventions

Expand Down
1 change: 0 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,6 @@ this repo automatically. Do not hand-edit it.
assets, tagged `v<info.version>+<YYYYMMDD>.<shortsha>` so every spec traces back to the source
commit that built it.
- `CHANGELOG.md` - human-readable diff between releases (generated).
- `.spectral.yaml` - the lint ruleset shared by producer and consumers.

## Consuming the spec

Expand Down
Loading
Loading