Commit Graph
25 Commits
Author SHA1 Message Date
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 d575f272fc Record the pilot results of MIL-006
Task: MIL-006#4
2026-10-11 03:15:57 +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 d9cd3c67d4 Decide the publish destination of a release (ADR-0007)
Task: MIL-004#4
2026-10-10 22:58:40 +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 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 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 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 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 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 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 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 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 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 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 b282e10741 Review and accept PP-001 (RC-015)
Add review record RC-015, remove JSON from the credential failures of UC
candidate 2 and the answered MIL-001 items from Open Issues, accept PP-001
and update TM-001.
2026-10-10 10:44:01 +08:00
Tirsvad bc3bd07b29 Record the S01 stand-in rule and the wiki publish token decision
ADR-0002: an artifact approved by S01 counts as approved for the other
named reviewers, with the stand-in recorded. ADR-0003: the wiki is published
with a separate TOKEN_FOR_GITEA_WIKI, dot-named titles work. Add review
records RC-013 and RC-014 and update TM-001.
2026-10-10 10:29:35 +08:00
Tirsvad d0618d929f Review and accept ADR-0001 (RC-012)
Add review record RC-012, accept the ADR with the decision stated in two
sentences and update TM-001.
2026-10-10 09:19:41 +08:00
Tirsvad f5fb0238f3 Decide the wiki structure, page names and languages (ADR-0001)
English pages are generated and have no suffix; translations are named
<Page>.da and <Page>.ms, written by hand in wiki/, reviewed and checked for
staleness through a source hash. Add the ADR type to the registry.
2026-10-10 09:14:21 +08:00
Tirsvad 20361e881e Review and accept the MIL-005 publishing amendment (RC-011)
Add review record RC-011, accept MIL-005 and update TM-001.
2026-10-10 08:49:15 +08:00
Tirsvad ae4e257236 Review and accept BC-001, PP-001 and MIL-005 (RC-008 to RC-010)
Add review records, fix the last decision date in PP-001 and update TM-001.
2026-10-10 08:27:37 +08:00
Tirsvad 08ef26a6d3 Plan MIL-005: wiki pages in English, Danish and Bahasa Malaysia
Add milestone MIL-005 with seven tasks, schedule it in PP-001, add the wiki
to the Business Case scope and record the wiki languages in the registry.
The milestone is Proposed; no wiki work starts before it is accepted.
2026-10-10 08:22:22 +08:00
Tirsvad aa3f08876d Add traceability matrix TM-001 and review records RC-004 to RC-007 2026-10-10 08:03:30 +08:00
Tirsvad c017c06789 Add review records RC-001 to RC-003 for BC-001, PP-001 and MIL-001 2026-10-10 08:00:50 +08:00
TirsvadandClaude Sonnet 5.5 4de5438a88 Add project plan, milestones and SQA framework; document actual capabilities
Adopt the SQA/QC framework as a submodule and plan the project before any
further code: Business Case, Stakeholder Analysis (S01-S05), Project Plan with
use case candidates and prioritisation, and milestones MIL-001..MIL-004
(24 tasks, synced to Gitea as milestones 18-21 and issues #1-#24).

README now separates implemented from planned capabilities, has an English
sequence diagram and points at the scoped workflow. The workflow file moves
out of the repository root and out of .gitea/workflows/; the scoped copy is
unchanged in behaviour here and still contains the known `exit 0` syntax
error, which MIL-001 fixes.

Refs #1
Refs #2
Refs #3
Refs #6

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-03 20:28:44 +08:00