MIL-002: Credential preflight, categorized errors and operations guides #27

Merged
Tirsvad merged 3 commits from mil-002-onboarding-and-operations into main 2026-10-03 15:29:18 +02:00
Owner

Summary

MIL-002 (tasks 2-7) and the acceptance of MIL-002 to MIL-004.

  • Marks MIL-002, MIL-003 and MIL-004 as Accepted in their version histories (first commit).
  • Sync workflow: failures are reported as ERROR: [category] message (configuration, credentials, permissions, api). Before changing anything, the workflow checks that the GitHub token can administer the mirror repository and stops with a permissions error otherwise. No secret value is printed.
  • Adds guides/onboarding.md (steps, runner labels and prerequisites), guides/credentials.md (minimum permissions, preflight, rotation) and guides/troubleshooting.md (every message mapped to a category and a fix).
  • Adds 12 offline tests (58 in total, run in a venv) and updates the README capability table.
  • Records the scoped workflow check in MIL-002: Gitea 1.27.3 runs the workflow in this repository (run 16).

Notes for the reviewer

  • Behaviour change: error text and category prefixes changed; the preflight adds one extra GitHub GET before the update.
  • Not verified: delivery of the scoped workflow to other repositories, and the minimum token permissions (taken from documentation; S05 should confirm with minimal tokens).
  • Not done: MIL-002 task 1 (brief use cases) needs a use case diagram and user stories first. Issue #8 stays open.
  • No RC-* review records exist for the accepted milestones.

No issue closed: every MIL-002 task issue stays open for review.

Refs #9
Refs #10
Refs #11
Refs #12
Refs #13
Refs #14
Refs #8

## Summary MIL-002 (tasks 2-7) and the acceptance of MIL-002 to MIL-004. - Marks MIL-002, MIL-003 and MIL-004 as `Accepted` in their version histories (first commit). - Sync workflow: failures are reported as `ERROR: [category] message` (`configuration`, `credentials`, `permissions`, `api`). Before changing anything, the workflow checks that the GitHub token can administer the mirror repository and stops with a `permissions` error otherwise. No secret value is printed. - Adds `guides/onboarding.md` (steps, runner labels and prerequisites), `guides/credentials.md` (minimum permissions, preflight, rotation) and `guides/troubleshooting.md` (every message mapped to a category and a fix). - Adds 12 offline tests (58 in total, run in a venv) and updates the README capability table. - Records the scoped workflow check in MIL-002: Gitea 1.27.3 runs the workflow in this repository (run 16). ## Notes for the reviewer - Behaviour change: error text and category prefixes changed; the preflight adds one extra GitHub `GET` before the update. - Not verified: delivery of the scoped workflow to other repositories, and the minimum token permissions (taken from documentation; S05 should confirm with minimal tokens). - Not done: MIL-002 task 1 (brief use cases) needs a use case diagram and user stories first. Issue #8 stays open. - No `RC-*` review records exist for the accepted milestones. No issue closed: every MIL-002 task issue stays open for review. Refs #9 Refs #10 Refs #11 Refs #12 Refs #13 Refs #14 Refs #8
Tirsvad added 3 commits 2026-10-03 15:27:40 +02:00
Set the owner/reviewer revision of each milestone to Accepted and deprecate
its initial row, as the Product Owner accepted the milestones. No task
content changed.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Sync workflow: every failure is now reported as `ERROR: [category] message`
with the categories configuration, credentials (HTTP 401), permissions
(HTTP 403) and api (other HTTP errors, unreachable service); HTTP 404 is a
configuration error. Before changing anything the workflow checks that the
GitHub token can administer the mirror repository and stops with a
permissions error otherwise. No secret value is printed.

Guides: onboarding (with runner labels, prerequisites and offline runner
symptoms), credentials (minimum permissions, preflight, rotation) and
troubleshooting (every message mapped to a category and a fix). README
capability table updated. MIL-002 records the verification of scoped
workflow support: Gitea 1.27.3 runs the workflow in this repository;
delivery to other repositories is not yet verified.

Task: MIL-002#2
Task: MIL-002#3
Task: MIL-002#4
Task: MIL-002#5
Task: MIL-002#6
Task: MIL-002#7
Refs #9
Refs #10
Refs #11
Refs #12
Refs #13
Refs #14

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Resolve pending commit link in MIL-002 version history
Validate workflows / validate (pull_request) Successful in 20s
a1561e2c6c
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Tirsvad merged commit ab122d2073 into main 2026-10-03 15:29:18 +02:00
Tirsvad deleted branch mil-002-onboarding-and-operations 2026-10-03 15:29:23 +02:00
Sign in to join this conversation.