TirSystem/git-workflows
0
2
Fork 0
Code Issues 40 Pull Requests Actions Packages Projects Releases 11 Wiki Activity

Scoped wiki publishing (MIL-014) and rename to git-workflows (MIL-015) #219

Merged
Tirsvad merged 13 commits from mil-014-scoped-wiki-publishing into main 2026-10-27 16:34:30 +01:00
Conversation 0 Commits 13 Files Changed 41
+111 -30
5 changed files with 111 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 081a17d07f - Show all commits
docs/artifact-registry.md
+1 -1
View File
@@ -11,7 +11,7 @@ each document lives in *this* project and the next version to use.
| SA | Stakeholder Analysis | docs/stakeholder-analysis.md | 002 |
| PP | Project Plan | docs/project-plan.md | 002 |
| MIL | Milestone / Gateway | docs/milestones/*.md | 016 |
| RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 088 |
| RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 089 |
| TM | Traceability Matrix | docs/sqa/traceability-matrix.md | 002 |
| ADR | Architecture Decision Record | docs/adr/adr-NNNN-*.md | 0014 |
| UCD | Use Case Diagram | docs/use-case-diagram.md | 002 |
docs/milestones/mil-015-rename-to-git-workflows.md
+26 -21
View File
@@ -4,37 +4,41 @@
| Key | Value |
| --- | --- |
| ID | MIL-015 |
| CrossReference | [BC-001], [MIL-014], [ADR-0006], [RC-087] |
| CrossReference | [BC-001], [MIL-014], [ADR-0006], [RC-087], [RC-088] |
## Version History
| Date | Status | Author | Reviewer | Change | Commit |
| --- | --- | --- | --- | --- | --- |
| 2026-10-27 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version; accepted on a Go review (RC-087); accepted by the author in chat on 2026-10-27 as stand-in for S01, not independent | [851b24c] |
| 2026-10-27 | Deprecated | Jens Tirsvad Nielsen | S01 | Initial version; accepted on a Go review (RC-087); accepted by the author in chat on 2026-10-27 as stand-in for S01, not independent | [851b24c] |
| 2026-10-27 | Accepted | Jens Tirsvad Nielsen | S01 | Updated to pull request 218 (live files renamed) and the removed required check: purpose, deliverable, criterion 5 and tasks 1, 3 and 4; reviewed (RC-088), accepted by the author in chat as stand-in for S01, not independent | pending |
---
## Purpose
Decide whether every place that names the repository `TirSystem/github-action`
now names `TirSystem/git-workflows`, which is its name on the instance. The old
name is in 369 places outside the `framework/` submodule (checked on 2026-10-27:
41 in code and configuration, 128 in user documentation, 184 in milestones, ADRs,
review records and the plan, and 16 in the Business Case, the use cases and the
user stories). Two things follow from it today: the workflows that fetch their
scripts name a repository that may now exist only through a redirect (task 2 checks it), and the branch
protection of `main` requires a check named `TirSystem/github-action: Sync
GitHub mirror metadata / sync-metadata (push)`, which no run of
`TirSystem/git-workflows` can produce, so a pull request cannot satisfy it.
now names `TirSystem/git-workflows`, which is its name on the instance. When this
milestone was accepted the old name was in 369 places outside the `framework/`
submodule. Since then pull request 218 (merged on 2026-10-27) renamed the live
files (code, configuration, README, guides and wiki pages), and the required
status check of `main` that carried the old name is gone: the protection of
`main` now has status checks switched off (read back through the API on
2026-10-27). What is left (checked on 2026-10-27): 194 places in milestones,
ADRs, review records and the plan, 16 in the Business Case, the use cases and the
user stories, and four mentions of `tailscale/github-action` and the changelog,
which are not the old name of this repository. What also remains is the
repositories that call a workflow here, whether the old name still resolves, and
a release.
## Deliverable
Code, configuration and user documentation that name `TirSystem/git-workflows`
(`repository:` and `uses:` lines, the wiki source URL, the tests, `AGENTS.md`,
README, guides and the wiki pages in three languages); the history (milestones,
ADRs, review records, changelog) left as written, with the rename recorded once
in the Project Plan; a branch protection whose required checks can be produced;
the repositories that call a workflow of this repository pointing at the new
name; and a release that carries the change.
(done by this milestone's task 1 and by pull request 218); the history
(milestones, ADRs, review records, changelog) left as written, with the rename
recorded once in the Project Plan; a branch protection whose required checks can
be produced (status checks are off today); the repositories that call a workflow
of this repository pointing at the new name; and a release that carries the
change.
## Go / No-Go Criteria
@@ -44,7 +48,7 @@ name; and a release that carries the change.
| 2 | A search of README, `guides/` and `docs/wiki/` finds the old name only where a sentence explains the rename | Offline tests pass and `python tools/build_wiki.py --check` is clean | A match remains, or a test fails |
| 3 | The history is unchanged | `git diff` of `docs/milestones/`, `docs/adr/` and `docs/sqa/reviews/` against `main` shows only the files of this milestone | A past milestone, ADR or review record is rewritten |
| 4 | The old name still resolves for `uses:`, `repository:` and the tags `v1` and `v2` on this instance, or the release is major | A workflow that calls `TirSystem/github-action/...@v2` and one that checks it out succeed in a test repository | Either fails and the release is not major |
| 5 | The required checks of `main` can be produced by a pull request | The pull request of this milestone shows every required check as passed or not required | A required check name that no run produces |
| 5 | The required checks of `main` can be produced by a pull request | Status checks are off, or every required context is produced by a run of this repository, read back through the API | A required context that no run produces |
| 6 | Every repository of the four organizations that calls a workflow of this repository, or checks it out, names the new repository | A scan lists none with the old name | Any remains, or a run fails after its change |
| 7 | The GitHub push mirror and the description and topics sync still work | The next run of **Sync GitHub mirror metadata** succeeds and the GitHub repository shows the same description and topics | A run fails |
| 8 | The release is published with a changelog entry that names the rename | Tag and release page read back through the API | No entry, or `v1` or `v2` moved |
@@ -77,10 +81,10 @@ name; and a release that carries the change.
| # | Task | Summary | Needs its own Use Case/User Story? | Reference |
| --- | --- | --- | --- | --- |
| 1 | Rename in code and configuration | Replace `TirSystem/github-action` in the workflows that fetch their scripts, `tools/build_wiki.py`, the tests, the comment fixtures and `AGENTS.md`, and rebuild the wiki pages that depend on the source URL. Leave `tailscale/github-action`, a different repository. Done in the working tree and tested (674 tests pass); it needs this milestone accepted to be committed. | No | |
| 1 | Rename in code and configuration | Done. Replaced `TirSystem/github-action` in the workflows that fetch their scripts, `tools/build_wiki.py`, the tests, the comment fixtures and `AGENTS.md`, and rebuilt the wiki pages that depend on the source URL; `tailscale/github-action`, a different repository, is untouched. Pull request 218 made the same change in the live files at the same time; the merge into the branch resolved to one result (674 tests pass, wiki check clean). | No | |
| 2 | Check the old name on the instance | In a test repository run a workflow that calls `TirSystem/github-action/.gitea/workflows/...@v2` and one that checks the repository out at `v2`, and record whether the redirect holds; check the GitHub push mirror and the metadata sync. The result decides the version of the release (criterion 4). | No | |
| 3 | Fix the required checks | Ask S01 or S03 to remove the required check `TirSystem/github-action: Sync GitHub mirror metadata / sync-metadata (push)` from the protection of `main` (it runs only on a push to `main`, so a pull request never produces it); the AI does not change branch protection. | No | |
| 4 | Rename in user documentation | Replace the old name in README, the guides and the wiki pages in three languages (128 places) and mention the rename once in the Project Plan; leave milestones, ADRs, review records and the changelog as written, and list the Business Case, Stakeholder Analysis, use cases, use case diagram and user stories (16 places) for S01 to decide, because they name the project as it was. Start after the pull request of MIL-014 has merged. | No | |
| 3 | Fix the required checks | Done by S01 or S03: the required check `TirSystem/github-action: Sync GitHub mirror metadata / sync-metadata (push)` is gone; on 2026-10-27 the protection of `main` showed status checks off (`enable_status_check` false, no contexts). The AI did not change branch protection. What remains is a decision: switch status checks back on with only `Validate workflows / validate (pull_request)`, so the offline tests gate the merge again. | No | |
| 4 | Record the rename and the rest of the documents | Mention the rename once in the Project Plan (done in the planning assumption) and list the Business Case, Stakeholder Analysis, use cases, use case diagram and user stories (16 places) for S01 to decide, because they name the project as it was. README, guides and the wiki pages were renamed by pull request 218 and need nothing more. Milestones, ADRs, review records and the changelog stay as written. | No | |
| 5 | Update the callers | Scan the four organizations for `uses: TirSystem/github-action/` and `repository: TirSystem/github-action`, and change each in a pull request per repository; include the framework (`sqa-qc-framework`, its `AGENTS.md` table and templates), which is released first. | No | |
| 6 | Verify | After the changes read back: the searches of criteria 1 and 2, the first run of every changed caller, the next metadata sync. Record the results in this milestone. | No | |
| 7 | Release | Changelog entry that names the rename; version as decided in task 2; release through the release workflow; the moving major tags are unchanged. | No | |
@@ -92,3 +96,4 @@ name; and a release that carries the change.
[ADR-0006]: ../adr/adr-0006-release-process-and-version-pinning.md
[RC-087]: ../sqa/reviews/rc-087-mil-015.md
[851b24c]: https://git.tirsystem.com/TirSystem/git-workflows/commit/851b24c63a8cd8a054cb380c1396a20de0686161
[RC-088]: ../sqa/reviews/rc-088-mil-015-update.md
docs/project-plan.md
+3 -4
View File
@@ -9,8 +9,8 @@
## Version History
| Date | Status | Author | Reviewer | Change | Commit |
| --- | --- | --- | --- | --- | --- |
| 2026-10-27 | Deprecated | Jens Tirsvad Nielsen | S01 | Added MIL-014 (wiki publishing as a scoped workflow, reversing part of ADR-0009); reviewed (RC-086), accepted by the author in chat as stand-in for S01 | [1fd6ae4] |
| 2026-10-27 | Accepted | Jens Tirsvad Nielsen | S01 | Added MIL-015 (rename the repository references to git-workflows; the repository was called github-action); reviewed (RC-087), accepted by the author in chat as stand-in for S01 | [851b24c] |
| 2026-10-27 | Deprecated | Jens Tirsvad Nielsen | S01 | Added MIL-015 (rename the repository references to git-workflows; the repository was called github-action); reviewed (RC-087), accepted by the author in chat as stand-in for S01 | [851b24c] |
| 2026-10-27 | Accepted | Jens Tirsvad Nielsen | S01 | Updated MIL-015 to pull request 218 and the removed required check; reviewed (RC-088), accepted by the author in chat as stand-in for S01 | pending |
---
@@ -26,7 +26,7 @@ workflows. The Business Case sets no deadline, so the dates are the plan's own;
- MIL-012 (VPN actions for deployment) runs from 2026-10-26 to its Target Date, 2026-11-06, proposed by the author and accepted by S01 in chat on 2026-10-19; it overlaps MIL-002 and MIL-003, which do not touch the runners' network.
- MIL-013 (source code comments are in English) runs from 2026-11-09 to its Target Date, 2026-11-20, proposed by the author and accepted by S01 in chat on 2026-10-19; it overlaps MIL-009, whose work is on wiki callers and does not touch the runners or the reviewer of the check.
- MIL-014 (publish wiki pages as a scoped workflow) runs from 2026-11-23 to its Target Date, 2026-11-27, proposed by the author; it follows MIL-013 so that release 3.0.0 carries one breaking change, and it reverses part of ADR-0009. S01 confirms the dates when accepting it.
- MIL-015 (rename the repository references to git-workflows) runs from 2026-10-28 to its Target Date, 2026-11-06, proposed by the author because the branch protection of `main` requires a check named after the old repository name; it overlaps MIL-012. Its documentation task follows the merge of MIL-014. The repository was called `github-action` until its rename; the milestones, ADRs and review records written under that name are not rewritten.
- MIL-015 (rename the repository references to git-workflows) runs from 2026-10-28 to its Target Date, 2026-11-06, proposed by the author because the branch protection of `main` required a check named after the old repository name; it overlaps MIL-012. Pull request 218 renamed the live files and the check was removed on 2026-10-27, so the milestone keeps the callers, the check of the old name on the instance, the 16 project documents for S01 and the release. Its documentation task follows the merge of MIL-014. The repository was called `github-action` until its rename; the milestones, ADRs and review records written under that name are not rewritten.
- Work on a milestone starts only after its `MIL-*` document is `Accepted`.
- Dates were confirmed on 2026-10-10 by S01, standing in for S05 (ADR-0002).
@@ -321,5 +321,4 @@ no tests, no release process.
[Milestone MIL-008]: https://git.tirsystem.com/TirSystem/github-action/milestone/152
[c5d5941]: https://git.tirsystem.com/TirSystem/github-action/commit/c5d59418698316866807388bf61dcb6166d9fa8b
[e35b1c5]: https://git.tirsystem.com/TirSystem/github-action/commit/e35b1c56748a50430503f5518602469f93262357
[1fd6ae4]: https://git.tirsystem.com/TirSystem/git-workflows/commit/1fd6ae4ee07202dcd57caffdd267758ea20af005
[851b24c]: https://git.tirsystem.com/TirSystem/git-workflows/commit/851b24c63a8cd8a054cb380c1396a20de0686161
docs/sqa/reviews/rc-088-mil-015-update.md
+76
View File
@@ -0,0 +1,76 @@
# Review Record: MIL-015 after pull request 218 and PP-001 (MIL-015)
## Metadata
| Key | Value |
| --- | --- |
| ID | RC-088 |
| CrossReference | [MIL-015], [PP-001], [RC-087], [QC-MIL-001], [QC-PP-001] |
## Version History
| Date | Status | Author | Reviewer | Change | Commit |
| --- | --- | --- | --- | --- | --- |
| 2026-10-27 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version; accepted by the author in chat on 2026-10-27 as stand-in for S01 | pending |
---
## Artifact Under Review
- Instance reviewed: [MIL-015]; delta of [PP-001] for the changed row and assumption
- Checklists used: [QC-MIL-001] for the milestone; [QC-PP-001] for the plan
- Scope: delta re-review of MIL-015 (purpose, deliverable, criterion 5, tasks 1, 3 and 4; criteria 1 to 6 of the checklist re-read) and of PP-001 (criteria 3, 8, 10, 11, 13 and 15), reason: pull request 218 renamed the live files and the required check of `main` was removed after RC-087; earlier record [RC-087]
- Language and domain: n/a (technical type)
- Language reviewer: none
- Mode: supervised, not independent (the author, Jens Tirsvad Nielsen, asked in chat on 2026-10-27 for the update and the review and stands in for S01; the AI prepared the evidence)
## Checklist Results
MIL-015 against [QC-MIL-001]:
| # | Criterion | Status | Evidence/Notes |
| --- | --- | --- | --- |
| 1 | A concrete deliverable is defined for every gate | Pass | The deliverable now says what is done (live files, by task 1 and pull request 218) and what is not (history stays, status checks are off, callers, a release). |
| 2 | Explicit Go/No-Go criteria | Pass | Eight criteria. Criterion 5 now reads: status checks off, or every required context produced by a run of this repository, read back through the API; the old wording ("passed or not required") could not be read back. |
| 3 | Dependencies are mapped | Pass | Unchanged: the pull request of MIL-014 and ADR-0006. The documentation task that waited for it is replaced by a record-only task. |
| 4 | Traceable to a Business Case objective | Pass | O2 and O4 of [BC-001], unchanged. |
| 5 | Owner and approving reviewer | Pass | S05 and S01. |
| 6 | Target date consistent with the constraints | Pass | 2026-11-06 unchanged; fewer tasks remain. |
Facts the update rests on, each read on 2026-10-27:
| Claim | Evidence |
| --- | --- |
| Pull request 218 renamed the live files | Merged into `main` as `8327038`; `git grep github-action` in code, configuration, README, guides and wiki pages now finds only `tailscale/github-action` (another repository) and one changelog line. |
| The required check is gone | `GET .../branch_protections/main`: `enable_status_check` false, `status_check_contexts` null, `required_approvals` 0. |
| What remains | 194 places in 114 history files, 16 in 12 project documents. |
PP-001 delta against [QC-PP-001]:
| # | Criterion | Status | Evidence/Notes |
| --- | --- | --- | --- |
| 3 | Decision dates agree with the `MIL-*` document | Pass | 2026-11-06 in both. |
| 8 | Assumptions are listed with their source | Pass | The MIL-015 assumption now records that pull request 218 and the removed check changed the scope, and what remains. |
| 10 | Open issues are current | Pass | No open issue contradicts the row. |
| 11 | The plan deliverable matches the `MIL-*` deliverable | Pass | The plan row (code, configuration and documentation name the new repository, callers updated, producible checks, released) still matches. |
| 13 | Schedule view and dependency view agree | Pass | Unchanged. |
| 15 | The plan is a singleton and changes are in Version History | Pass | New row; the two latest are kept. |
## Overall Verdict
Go. The update is smaller than the plan accepted in RC-087: tasks 1 and 3 are done and task 4 shrinks to a record and a list for S01. The first read found one weakness, now fixed: switching status checks off removed the gate for the offline tests too, so the protection is weaker than before the rename; this is an action item, not a fault in the milestone. The author accepted the update in chat on 2026-10-27 as stand-in for S01; this is not an independent review.
## Action Items
| Action | Owner | Due |
| --- | --- | --- |
| Confirm this record by S01 when an independent reading is possible | S01 | 2026-11-06 |
| Decide whether to switch status checks on `main` back on with only `Validate workflows / validate (pull_request)`; today no check gates the merge | S01 | 2026-11-06 |
| Decide whether the Business Case, Stakeholder Analysis, use cases, use case diagram and user stories change the name (16 places) | S01 | 2026-11-06 |
---
[MIL-015]: ../../milestones/mil-015-rename-to-git-workflows.md
[PP-001]: ../../project-plan.md
[BC-001]: ../../business-case.md
[RC-087]: ./rc-087-mil-015.md
[QC-MIL-001]: ../../../framework/qc/artifacts/qc-milestones-gateways.md
[QC-PP-001]: ../../../framework/qc/artifacts/qc-project-plan.md
docs/sqa/traceability-matrix.md
+5 -4
View File
@@ -9,8 +9,8 @@
## Version History
| Date | Status | Author | Reviewer | Change | Commit |
| --- | --- | --- | --- | --- | --- |
| 2026-10-27 | Proposed | Jens Tirsvad Nielsen | S01 | Added MIL-014 (scoped wiki publishing), ADR-0013 and RC-086 (their review) | [1fd6ae4] |
| 2026-10-27 | Proposed | Jens Tirsvad Nielsen | S01 | Added MIL-015 (rename to git-workflows) and RC-087 (its review) | [851b24c] |
| 2026-10-27 | Proposed | Jens Tirsvad Nielsen | S01 | Added RC-088 (MIL-015 updated to pull request 218) | pending |
---
@@ -26,7 +26,7 @@ updated whenever an artifact instance is created or reviewed.
| --- | --- | --- | --- | --- |
| [SA-001] | SA | - | [BC-001], [UCD-001] | [RC-004] |
| [BC-001] | BC | [SA-001] | [PP-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006], [MIL-012], [MIL-013], [MIL-014], [MIL-015] | [RC-001], [RC-008], [RC-067], [RC-081], [RC-084] |
| [PP-001] | PP | [BC-001], [SA-001] | [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006], [MIL-007], [MIL-008], [MIL-009], [MIL-010], [MIL-011], [MIL-012], [MIL-013], [MIL-014], [MIL-015], [US-001] | [RC-002], [RC-009], [RC-015], [RC-017], [RC-025], [RC-032], [RC-053], [RC-062], [RC-064], [RC-068], [RC-080], [RC-083], [RC-086], [RC-087] |
| [PP-001] | PP | [BC-001], [SA-001] | [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006], [MIL-007], [MIL-008], [MIL-009], [MIL-010], [MIL-011], [MIL-012], [MIL-013], [MIL-014], [MIL-015], [US-001] | [RC-002], [RC-009], [RC-015], [RC-017], [RC-025], [RC-032], [RC-053], [RC-062], [RC-064], [RC-068], [RC-080], [RC-083], [RC-086], [RC-087], [RC-088] |
| [MIL-001] | MIL | [BC-001], [PP-001] | [MIL-002] | [RC-003], [RC-026] |
| [MIL-002] | MIL | [BC-001], [PP-001], [MIL-001] | [MIL-003], [MIL-005] | [RC-005], [RC-027] |
| [MIL-003] | MIL | [BC-001], [PP-001], [MIL-002] | [MIL-004] | [RC-006], [RC-028], [RC-033], [RC-039] |
@@ -51,7 +51,7 @@ updated whenever an artifact instance is created or reviewed.
| [MIL-012] | MIL | [BC-001], [PP-001], [MIL-004], [MIL-011], [ADR-0006], [ADR-0011] | - | [RC-080], [RC-082] |
| [MIL-013] | MIL | [BC-001], [PP-001], [MIL-004], [MIL-010], [MIL-011], [ADR-0005], [ADR-0006], [ADR-0010] | - | [RC-083], [RC-085] |
| [MIL-014] | MIL | [BC-001], [PP-001], [MIL-009], [MIL-013], [ADR-0004], [ADR-0009], [ADR-0013] | - | [RC-086] |
| [MIL-015] | MIL | [BC-001], [PP-001], [MIL-014], [ADR-0006] | - | [RC-087] |
| [MIL-015] | MIL | [BC-001], [PP-001], [MIL-014], [ADR-0006] | - | [RC-087], [RC-088] |
| [RC-007] | RC | [MIL-004] | - | - |
| [RC-008] | RC | [BC-001] | - | - |
| [RC-009] | RC | [PP-001] | - | - |
@@ -152,6 +152,7 @@ updated whenever an artifact instance is created or reviewed.
| [RC-085] | RC | [MIL-013] | - | - |
| [RC-086] | RC | [ADR-0013], [MIL-014], [PP-001] | - | - |
| [RC-087] | RC | [MIL-015], [PP-001] | - | - |
| [RC-088] | RC | [MIL-015], [PP-001] | - | - |
## Coverage Notes
@@ -186,6 +187,7 @@ updated whenever an artifact instance is created or reviewed.
[RC-086]: ./reviews/rc-086-adr-0013-mil-014-pp-001.md
[MIL-015]: ../milestones/mil-015-rename-to-git-workflows.md
[RC-087]: ./reviews/rc-087-mil-015.md
[RC-088]: ./reviews/rc-088-mil-015-update.md
[RC-001]: ./reviews/rc-001-business-case.md
[RC-002]: ./reviews/rc-002-project-plan.md
[RC-003]: ./reviews/rc-003-mil-001.md
@@ -291,5 +293,4 @@ updated whenever an artifact instance is created or reviewed.
[UC-005]: ../uc-005/uc.md
[ADR-0005]: ../adr/adr-0005-quality-check-contract.md
[3d7a9df]: https://git.tirsystem.com/TirSystem/github-action/commit/3d7a9df3a3a4712dcc5214a71b0569d90122bf4e
[1fd6ae4]: https://git.tirsystem.com/TirSystem/git-workflows/commit/1fd6ae4ee07202dcd57caffdd267758ea20af005
[851b24c]: https://git.tirsystem.com/TirSystem/git-workflows/commit/851b24c63a8cd8a054cb380c1396a20de0686161