add API issue and release scaffolding

2026-10-25 05:21:26 +01:00
parent 29c63121f4
commit 20086b7776
4 changed files with 66 additions and 0 deletions
@@ -0,0 +1,19 @@
+name: Bug report
+description: Report a reproducible defect.
+title: 'bug: '
+labels: [bug]
+body:
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction
+      description: List the smallest deterministic reproduction and expected behavior.
+    validations:
+      required: true
+  - type: textarea
+    id: verification
+    attributes:
+      label: Verification context
+      description: Include repository, branch, version, and relevant checks. Never include secrets.
+    validations:
+      required: true
@@ -0,0 +1,18 @@
+name: Feature request
+description: Propose a change that is consistent with PLAN.md.
+title: 'feature: '
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem and proposed behavior
+    validations:
+      required: true
+  - type: checkboxes
+    id: plan
+    attributes:
+      label: Planning
+      options:
+        - label: I checked PLAN.md and this does not silently change an existing decision.
+          required: true
@@ -0,0 +1,19 @@
+name: API release check
+
+on:
+  workflow_dispatch:
+  push:
+    tags: ['v*.*.*']
+
+jobs:
+  release-check:
+    runs-on: debian-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - name: Validate release metadata
+        run: test -s CHANGELOG.md && test -s README.md && test -s docs/versioning.md
+      - name: Validate JSON
+        run: node --input-type=module -e "import { readdir, readFile } from 'node:fs/promises'; for (const d of ['contracts/v1','fixtures/v1']) for (const f of await readdir(d)) if (f.endsWith('.json')) JSON.parse(await readFile(d + '/' + f, 'utf8'));"
@@ -0,0 +1,10 @@
+# Changelog
+
+All notable API contract changes are recorded here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Development work is
+performed on `dev`; stable release entries are added when the user authorizes a
+release.
+
+## [Unreleased]
+
+- Add versioned backup inventory and manual-backup response contracts.