100 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
Tirsvad	92c1795379	Resolve pending commit links in the MIL-007 use case documents	2026-10-11 12:26:59 +08:00
Tirsvad	32b5ab62ab	Extend UC-005 and US-001 to C++ and C#, and record the runner tools of MIL-007	2026-10-11 12:26:58 +08:00
Tirsvad	2172939527	Merge pull request 'Plan MIL-007: quality checks for C++ and C#' (#94) from plan-mil-007-cpp-csharp into main ... Reviewed-on: #94	2026-10-11 06:23:15 +02:00
Tirsvad	4c51435b16	Link the MIL-007 milestone in the project plan	2026-10-11 12:22:06 +08:00
Tirsvad	bdf89d38d9	Resolve pending commit links in the MIL-007 acceptance	2026-10-11 12:21:35 +08:00
Tirsvad	e3ad1fa7e7	Review and accept MIL-007 and the PP-001 amendment	2026-10-11 12:21:33 +08:00
Tirsvad	8ad19fca8d	Resolve pending commit links in the MIL-007 plan	2026-10-11 12:19:57 +08:00
Tirsvad	b74ee0e5cf	Plan MIL-007: quality checks for C++ and C#	2026-10-11 12:19:56 +08:00
Tirsvad	07a5f9b084	Merge pull request 'Record the verification of pinned consumers in MIL-004' (#93) from mil-004-pin-verified into main	2026-10-11 06:18:37 +02:00
Tirsvad	fd62602c40	Resolve pending commit links in the MIL-004 pin verification ... Task: MIL-004#1	2026-10-11 12:17:58 +08:00
Tirsvad	05b635c1b3	Record the verification of pinned consumers in MIL-004 ... Task: MIL-004#1	2026-10-11 12:17:57 +08:00
Tirsvad	9cd723fb48	Merge pull request 'Add a coverage gate to validate-workflows' (#92) from coverage-gate into main	2026-10-11 06:07:53 +02:00
Tirsvad	075fae2e45	Add a coverage gate to validate-workflows and stop tracking .coverage ... Task: MIL-003#3	2026-10-11 12:05:47 +08:00
Tirsvad	80fb0cfa82	Merge pull request 'Test the HTTP and command-line paths of the tools' (#91) from test-tools-coverage into main	2026-10-11 05:27:08 +02:00
Tirsvad	eb3e1395db	Test the HTTP and command-line paths of the tools ... Task: MIL-003#3	2026-10-11 11:26:45 +08:00
Tirsvad	2817ecdef5	Merge pull request 'Run the quality checks from a script file' (#90) from quality-checks-script-file into main	2026-10-11 05:15:53 +02:00
Tirsvad	0025c58e7b	Add the changelog entry of release 1.1.0 ... Task: MIL-004#5	2026-10-11 11:15:13 +08:00
Tirsvad	ae0360350a	Resolve pending commit links in the quality-checks script documents ... Task: MIL-003#3	2026-10-11 11:14:04 +08:00
Tirsvad	670f0ac469	Run the quality checks from a script file of this repository ... Task: MIL-003#3	2026-10-11 11:14:03 +08:00
Tirsvad	6f01fd6828	Merge pull request 'Add the changelog entry of release 1.0.1' (#89) from release-1-0-1 into main	2026-10-11 04:49:18 +02:00
Tirsvad	b8d08f7d90	Add the changelog entry of release 1.0.1 ... Task: MIL-004#5	2026-10-11 10:48:46 +08:00
Tirsvad	893890497a	Merge pull request 'End the sync log with Skipped when there is no GitHub mirror' (#88) from sync-skipped-without-mirror into main	2026-10-11 04:43:01 +02:00
Tirsvad	aa88ea6f8b	End the sync log with Skipped when there is no GitHub mirror ... Task: MIL-001#1	2026-10-11 10:42:18 +08:00
Tirsvad	532e9663cb	Merge pull request 'List all workflows with purpose and diagram on the Home page' (#87) from home-workflow-list into main	2026-10-11 04:39:22 +02:00
Tirsvad	4cb4689471	List all workflows with their purpose and a diagram on the Home page ... Task: MIL-005#3	2026-10-11 10:38:54 +08:00
Tirsvad	4b8d659e02	Merge pull request 'Name the quality-check wiki page for what it covers' (#86) from rename-quality-checks-wiki-page into main	2026-10-11 04:34:40 +02:00
Tirsvad	d8dc35e88f	Name the quality-check wiki page for what it covers ... Task: MIL-005#3	2026-10-11 10:33:47 +08:00
Tirsvad	21b9b83e82	Merge pull request 'Generate a _Sidebar page so the wiki shows its subpages' (#85) from mil-005-wiki-sidebar into main	2026-10-11 03:56:23 +02:00
Tirsvad	e6c855554c	Generate a _Sidebar page so the wiki shows its subpages ... Task: MIL-005#3	2026-10-11 09:55:58 +08:00
Tirsvad	e375900d2a	Merge pull request 'Accept the translations of MIL-005 and record its results' (#84) from mil-005-accept-translations into main	2026-10-11 03:48:39 +02:00
Tirsvad	4210a7492e	Resolve pending commit links in the MIL-005 results ... Task: MIL-005#5	2026-10-11 09:48:08 +08:00
Tirsvad	ead3d98d73	Accept the translations of MIL-005 and record its results ... Task: MIL-005#5	2026-10-11 09:48:06 +08:00
Tirsvad	2f1aa4d26d	Merge pull request 'Record the pilot results of MIL-006' (#83) from mil-006-pilot-results into main	2026-10-10 21:16:36 +02:00
Tirsvad	b85947f076	Resolve pending commit links in the MIL-006 results ... Task: MIL-006#4	2026-10-11 03:15:58 +08:00
Tirsvad	d575f272fc	Record the pilot results of MIL-006 ... Task: MIL-006#4	2026-10-11 03:15:57 +08:00
Tirsvad	81fd82a909	Merge pull request 'Pin the scoped workflows to v1 and record the MIL-004 results' (#82) from mil-004-pin-scripts-v1 into main	2026-10-10 21:04:23 +02:00
Tirsvad	513ad69de2	Resolve pending commit links in the MIL-004 results ... Task: MIL-004#1	2026-10-11 03:03:43 +08:00
Tirsvad	6933e91c83	Pin the scoped workflows to v1 and record the MIL-004 results ... Task: MIL-004#1	2026-10-11 03:03:42 +08:00
Tirsvad	97ffa49aae	Merge pull request 'Add the changelog entry of the first release, 1.0.0' (#81) from mil-004-release-1-0-0 into main	2026-10-10 17:03:24 +02:00
Tirsvad	8b972b33e9	Add the changelog entry of the first release, 1.0.0 ... Task: MIL-004#5	2026-10-10 23:02:50 +08:00
Tirsvad	be147af60c	Merge pull request 'Add the release workflow (MIL-004 task 5)' (#80) from mil-004-release-workflow into main	2026-10-10 17:02:00 +02:00
Tirsvad	27abd226c4	Add the release workflow and its script ... Task: MIL-004#5	2026-10-10 23:01:30 +08:00
Tirsvad	9ccefa5e3b	Merge pull request 'Decide the publish destination of a release (MIL-004 task 4)' (#79) from mil-004-publish-destination into main	2026-10-10 16:59:08 +02:00
Tirsvad	dbaf272fe5	Resolve pending commit links in the publish destination documents ... Task: MIL-004#4	2026-10-10 22:58:42 +08:00
Tirsvad	d9cd3c67d4	Decide the publish destination of a release (ADR-0007) ... Task: MIL-004#4	2026-10-10 22:58:40 +08:00
Tirsvad	afb1e219db	Merge pull request 'Add the consumer upgrade guide (MIL-004 task 3)' (#78) from mil-004-upgrade-guide into main	2026-10-10 16:56:36 +02:00
Tirsvad	2cf59b96bd	Resolve pending commit links in the upgrade guide documents ... Task: MIL-004#3	2026-10-10 22:55:43 +08:00
Tirsvad	4cf52afe00	Add the upgrade guide and the use case Consume a Workflow Update ... UC-007, US-001.14 and US-001.15, the upgrade guide on the wiki in three languages, and RC-044 to RC-046 with the traceability matrix. Task: MIL-004#3	2026-10-10 22:55:40 +08:00
Tirsvad	297095bdfb	Merge pull request 'Add the changelog and the check of its convention (MIL-004 task 2)' (#77) from mil-004-changelog-convention into main	2026-10-10 16:51:45 +02:00
Tirsvad	930e67ad7e	Add the changelog and the check of its convention ... CHANGELOG.md holds an [Unreleased] section with what the first release v1.0.0 will contain, in the groups Breaking, Added, Changed and Fixed. tools/changelog.py checks the convention of ADR-0006 (Unreleased first, descending versions, dates, a Breaking entry needs a new major and a new major needs one) and prints the notes of a release for the release page. The release process guide uses both. Task: MIL-004#2	2026-10-10 22:51:08 +08:00
Tirsvad	b1515b26e1	Merge pull request 'Define the release process and version pinning (MIL-004 task 1)' (#76) from mil-004-release-process into main	2026-10-10 16:49:36 +02:00
Tirsvad	a04b578d70	Resolve pending commit links in the release process documents	2026-10-10 22:46:26 +08:00
Tirsvad	044d8ba21f	Define the release process and version pinning ... Add the brief use case UC-006 (Release a Reusable Workflow), the use case in UCD-001, stories US-001.11 to US-001.13 and ADR-0006: one version for the repository with SemVer tags and a moving major tag, a release only from a green commit with a changelog entry, consumers pin the major or an exact tag and never main. Add the maintainers' checklist guides/release-process.md. Review and accept them (RC-040 to RC-043), update TM-001 and the registry. Task: MIL-004#1	2026-10-10 22:46:23 +08:00
Tirsvad	aa18811003	Merge pull request 'Move the publish script out of the scoped workflow into a file (MIL-004 task 6, part 2)' (#75) from mil-004-publish-script-as-file into main ... Reviewed-on: #75	2026-10-10 15:54:46 +02:00
Tirsvad	23abcd9491	Move the publish script out of the scoped workflow into a file ... tools/publish_wiki.py holds the 296 lines that were embedded in publish-wiki.yml, unchanged in behaviour and messages. The scoped workflow now checks out the repository that owns the wiki and TirSystem/github-action at main, and runs the file (42 lines instead of 313). The tests import the file, and a new test asserts that no workflow embeds Python. README and the Home wiki page with its translations no longer mention embedded Python. Verified live from TirSystem-BashScript/RepoFoundry. Task: MIL-004#6	2026-10-10 20:42:18 +08:00
Tirsvad	e6db4b56d3	Merge pull request 'Move the sync script out of the scoped workflow into a file (MIL-004 task 6, part 1)' (#74) from mil-004-sync-script-as-file into main ... Reviewed-on: #74	2026-10-10 14:31:23 +02:00
Tirsvad	ac20d1c2a1	Move the sync script out of the scoped workflow into a file ... tools/sync_github_metadata.py holds the 221 lines that were embedded in sync-github-metadata.yml, unchanged in behaviour and messages. The scoped workflow now checks out TirSystem/github-action at main and runs the file (33 lines instead of 230). The tests import the file instead of executing the YAML. Verified live from TirSystem-BashScript/RepoFoundry with that organisation's secrets. Task: MIL-004#6	2026-10-10 20:30:32 +08:00
Tirsvad	2ce02698e5	Merge pull request 'Add the guide for reading quality-check results (MIL-003 task 5)' (#73) from mil-003-results-guide into main ... Reviewed-on: #73	2026-10-10 14:26:38 +02:00
Tirsvad	820f05c0bd	Add the guide for reading quality-check results ... Explain how to call the shared quality-checks workflow, read a failed run, fix the typical findings of ruff, mypy, shellcheck and shfmt, reproduce a run locally and configure the tools through the project's own files, including the shfmt .editorconfig route found in the RepoFoundry trial. Add the QualityChecks wiki page with its Danish and Bahasa Malaysia translations, update the capability row and teach build_wiki.py the page. Task: MIL-003#5	2026-10-10 20:25:52 +08:00
Tirsvad	cbf4460289	Merge pull request 'Record the adoption of the quality checks in RepoFoundry (MIL-003 task 4)' (#72) from mil-003-adoption-record into main ... Reviewed-on: #72	2026-10-10 14:23:09 +02:00
Tirsvad	f69b38c228	Resolve pending commit links in MIL-003, RC-039 and TM-001	2026-10-10 20:13:13 +08:00
Tirsvad	3b8681d023	Record the adoption of the quality checks in RepoFoundry ... Run against TirSystem-BashScript/RepoFoundry (39 shell files): shellcheck passes with the project's .shellcheckrc, shfmt fails on 10 files only because of the case indentation and passes after one .editorconfig line; the pull request itself passes. Record the findings for the guide, review the change (RC-039) and update TM-001. The adoption is complete when RepoFoundry PR 76 is merged. Task: MIL-003#4	2026-10-10 20:13:11 +08:00
Tirsvad	4910a5b3fd	Merge pull request 'Add the reusable quality-check workflow (MIL-003 task 3)' (#71) from mil-003-quality-workflow into main ... Reviewed-on: #71	2026-10-10 10:19:02 +02:00
Tirsvad	45219a19f6	Add the reusable quality-check workflow ... quality-checks.yml implements the contract of ADR-0005: inputs for the languages, the working directory and one pinned version per tool; ruff, mypy --strict, shellcheck and shfmt installed from PyPI into a venv; every tool runs and any failure fails the job; a language without files is skipped with a notice. Offline tests run the shell steps with stub tools. Verified live from another organisation with clean files, a seeded failure and an empty language. Task: MIL-003#3	2026-10-10 16:13:57 +08:00
Tirsvad	00970dd909	Merge pull request 'Define the contract of the shared quality-check workflow (UC-005, ADR-0005)' (#70) from mil-003-quality-check-contract into main ... Reviewed-on: #70	2026-10-10 10:07:34 +02:00
Tirsvad	92a8b32f0e	Resolve pending commit links in the quality-check contract documents	2026-10-10 16:06:33 +08:00
Tirsvad	385d2fb7cb	Define and accept the contract of the shared quality-check workflow ... Add the brief use case UC-005 (Run Project Quality Checks), the actor and use case in UCD-001, stories US-001.09 and US-001.10, and ADR-0005 with the inputs, the pinned tools and what a pass and a fail mean, based on a probe of the runner image. Review and accept them (RC-035 to RC-038) and update TM-001 and the registry. Task: MIL-003#2	2026-10-10 16:06:30 +08:00
Tirsvad	bf077b1910	Merge pull request 'Plan MIL-004 task 6: move the embedded scripts of the scoped workflows to files' (#68) from mil-004-scripts-as-files into main ... Reviewed-on: #68	2026-10-10 07:42:08 +02:00
Tirsvad	9c357f79ca	Resolve pending commit links in MIL-004, RC-034 and TM-001	2026-10-10 13:41:37 +08:00
Tirsvad	616c5d2e48	Plan task 6 of MIL-004: move the embedded scripts to files ... The sync and publish-wiki scoped workflows embed 200 to 300 lines of Python in their YAML. Add task 6 to move them to tools/ and run them from a checkout of this repository, as verified from two organisations, with a Go/No-Go criterion and O2 in the traceability. Review and accept the amendment (RC-034) and update TM-001.	2026-10-10 13:41:36 +08:00
Tirsvad	da53cceb7c	Merge pull request 'Record that reusable workflows work on the instance (MIL-003 task 1)' (#67) from mil-003-reusable-workflows-verified into main ... Reviewed-on: #67	2026-10-10 07:33:46 +02:00
Tirsvad	f8879fcf06	Resolve pending commit links in MIL-003, RC-033 and TM-001	2026-10-10 13:32:31 +08:00
Tirsvad	b3f006f7a4	Record that reusable workflows work on the instance ... Verified on 2026-10-10 with throwaway branches (deleted afterwards): workflow_call and uses run from the same repository, another repository of the organisation and a repository of another organisation, so MIL-003 needs no copied-template fallback. Not tested: a private provider, secrets passed to a called workflow, and a tag reference. Review it (RC-033) and update TM-001. Task: MIL-003#1	2026-10-10 13:32:29 +08:00
Tirsvad	f99c8d545f	Merge pull request 'Approve the token permissions and confirm the target dates (S01 standing in for S05)' (#66) from mil-002-token-scopes into main ... Reviewed-on: #66	2026-10-10 07:24:53 +02:00
Tirsvad	e2c6bedb26	Resolve pending commit links in the milestones, PP-001, review records and TM-001	2026-10-10 13:23:44 +08:00
Tirsvad	ea06eaaa69	Approve the token permissions and confirm the target dates ... S01, standing in for S05 (ADR-0002), approves the minimum Gitea and GitHub token permissions, recorded with the evidence from the Gitea source and the GitHub documentation; they are still not tested with a minimal token on the instance. Confirm the target dates of MIL-001 to MIL-006 and PP-001 (RC-026 to RC-032), update TM-001 and regenerate the Credentials wiki page with its translations. Task: MIL-002#4	2026-10-10 13:23:40 +08:00
Tirsvad	5608630d3d	Merge pull request 'Write and accept the brief use cases for the P1 candidates (UCD-001, US-001, UC-001 to UC-004)' (#65) from mil-002-use-cases into main ... Reviewed-on: #65	2026-10-10 07:07:15 +02:00
Tirsvad	dc572470e7	Resolve pending commit links in the use case documents and review records	2026-10-10 13:04:33 +08:00
Tirsvad	a2bf2d4204	Write and accept the brief use cases for the P1 candidates ... Add the use case diagram UCD-001, the user stories US-001 and the brief use cases UC-001 to UC-004 (Synchronize Repository Metadata, Configure Workflow Credentials, Onboard a Repository, Diagnose a Failed Workflow). Review and accept them (RC-019 to RC-024) and the PP-001 row that records them (RC-025), and update TM-001 and the registry. Task: MIL-002#1	2026-10-10 13:04:30 +08:00
Tirsvad	e73975e3a6	Merge pull request 'Match wiki pages by address so names with spaces are the same page' (#64) from mil-006-wiki-title-identity into main ... Reviewed-on: #64	2026-10-10 06:01:01 +02:00
Tirsvad	b240ceb9f1	Match wiki pages by address so names with spaces are the same page ... Gitea stores the title "Home da" as Home-da. The publisher compared title strings, so a file named Home-da.md would have tried to create a page that already exists. Identify a page by the address Gitea reports (sub_url), treat a space and a hyphen as the same, and refuse two files that name one page. Found while preparing the pilot in sqa-qc-checklists, whose wiki has pages named with spaces. Task: MIL-006#3	2026-10-10 12:00:11 +08:00
Tirsvad	2dbc2819d4	Merge pull request 'Document how a repository opts in to wiki publishing' (#63) from mil-006-guides-and-wiki into main ... Reviewed-on: #63	2026-10-10 05:55:13 +02:00
Tirsvad	de2e28e637	Document how a repository opts in to wiki publishing ... Describe the wiki/.publish marker and the prune word, the per-organisation TOKEN_FOR_GITEA_WIKI without fallback, and the new messages in the onboarding, credentials and troubleshooting guides and the README. Add the capability row and regenerate the five English wiki pages with their Danish and Bahasa Malaysia translations. Task: MIL-006#5	2026-10-10 11:54:54 +08:00
Tirsvad	e530ecd99d	Merge pull request 'Make the wiki publisher a scoped workflow with an opt-in gate' (#62) from mil-006-scoped-publisher into main ... Reviewed-on: #62	2026-10-10 05:39:33 +02:00
Tirsvad	c4bbea4a2b	Make the wiki publisher a scoped workflow with an opt-in gate ... Embed the publish script in .gitea/scoped_workflows/publish-wiki.yml and remove the repository workflow and tools/publish_wiki.py. A repository publishes only when wiki/.publish exists; the word prune in it is the only thing that lets the workflow delete pages. The organisation's TOKEN_FOR_GITEA_WIKI is used with no fallback. This repository opts in with prune. Tests run the embedded script against a fake Gitea. Task: MIL-006#2 Task: MIL-006#3	2026-10-10 11:39:11 +08:00
Tirsvad	439de4ac60	Merge pull request 'Decide the opt-in rule and secret handling of the shared wiki publisher (ADR-0004)' (#61) from mil-006-adr-0004 into main ... Reviewed-on: #61	2026-10-10 05:34:49 +02:00
Tirsvad	92396e23c9	Resolve pending commit links in ADR-0004, RC-018 and TM-001	2026-10-10 11:34:14 +08:00
Tirsvad	b22a2cd592	Decide the opt-in rule and secret handling of the shared wiki publisher (ADR-0004) ... A repository opts in with wiki/.publish; the word prune in it is the only thing that lets the workflow delete pages. The shared workflow uses the organisation's TOKEN_FOR_GITEA_WIKI only. Review and accept it (RC-018), update TM-001 and link the MIL-006 milestone in PP-001.	2026-10-10 11:34:13 +08:00
Tirsvad	0230ed8c08	Merge pull request 'Review and accept MIL-006 and PP-001 (RC-016, RC-017)' (#55) from mil-006-accepted into main ... Reviewed-on: #55	2026-10-10 05:30:44 +02:00
Tirsvad	bf11aa25db	Resolve pending commit links in MIL-006, PP-001, RC-016, RC-017 and TM-001	2026-10-10 11:30:23 +08:00
Tirsvad	676a262405	Review and accept MIL-006 and PP-001 (RC-016, RC-017) ... Add review records RC-016 and RC-017, accept MIL-006 and the PP-001 row that adds it, and update TM-001.	2026-10-10 11:30:21 +08:00
Tirsvad	8d0fab71b5	Merge pull request 'Plan MIL-006: shared wiki publishing' (#54) from mil-006-shared-wiki-publishing into main ... Reviewed-on: #54	2026-10-10 05:26:31 +02:00
Tirsvad	be53de8f57	Resolve pending commit links in PP-001 and MIL-006	2026-10-10 11:26:10 +08:00
Tirsvad	6b8e36d67a	Plan MIL-006: shared wiki publishing ... Add milestone MIL-006 with five tasks: a scoped publish-wiki workflow with an opt-in rule, piloted in one other repository. Schedule it in PP-001. The milestone is Proposed; no code starts before it is accepted.	2026-10-10 11:26:09 +08:00
Tirsvad	e5b326213e	Merge pull request 'Record that scoped workflow delivery is verified across organisations' (#53) from onboarding-scoped-delivery-verified into main ... Reviewed-on: #53	2026-10-10 05:25:54 +02:00
Tirsvad	0ecdcbe804	Record that scoped delivery is verified across organisations ... The onboarding guide said delivery to other repositories was not verified. On 2026-10-10 the sync workflow ran without a copy in repositories of four organisations, so a repository needs no copy and each organisation needs its own secrets. Regenerate the Onboarding wiki page and its translations. Task: MIL-002#2	2026-10-10 11:15:38 +08:00
Tirsvad	b0dffbc1c3	Merge pull request 'Add the checklist for the wiki translation review' (#52) from wiki-translation-review-checklist into main ... Reviewed-on: #52	2026-10-10 05:02:27 +02:00
Tirsvad	c0a0a10c4b	Add the checklist for the wiki translation review ... A working document for the native readers of Danish and Bahasa Malaysia (MIL-005 task 5): page list with links, ten checks per page, the judgement calls to look at first, a findings table and an outcome table.	2026-10-10 11:02:02 +08:00
Tirsvad	7b37e40a79	Merge pull request 'Use bare tokens: PAT_FOR_GITHUB replaces CREDENTIALS_FOR_GITHUB' (#51) from pat-for-github into main ... Reviewed-on: #51	2026-10-10 04:44:41 +02:00
Tirsvad	0439867e89	Resolve pending commit links in PP-001, RC-015 and TM-001	2026-10-10 10:44:02 +08:00