Merge branch 'main' into wiki-update-the-framework
Quality checks / quality-checks (pull_request) Successful in 24s
Quality / quality (pull_request) Successful in 24s

This commit is contained in:
2026-10-12 22:09:57 +02:00
16 changed files with 391 additions and 1 deletions
+42
View File
@@ -0,0 +1,42 @@
<!-- translation of GettingStarted.md, source sha256 b030cafee29e -->
> Dette er en oversættelse af [`GettingStarted`](GettingStarted). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.
[English](GettingStarted) | Dansk | [Bahasa Melayu](GettingStarted.ms)
# Kom godt i gang
## Krav
| Værktøj | Bruges til |
| --- | --- |
| bash 4.4 eller nyere | scriptet (macOS leveres med 3.2: installér først en nyere bash) |
| `git` | det lokale projekt og framework-submodulet |
| `curl` | GitHub- og Gitea-API'erne |
| `ssh` (valgfri) | SSH-kontrollen; uden den springes framework-trinnene over |
| `jq` (valgfri) | JSON-læsning; uden den bruges en lille indbygget læser |
## Installation
```bash
git clone https://git.tirsystem.com/TirSystem-BashScript/repo-foundry.git
cd repo-foundry
src/create-project.sh --help
```
Intet installeres på hele systemet: scriptet kører fra checkout'et.
## Konfiguration
Kopiér `config.env.example` til `config.env` og `.env.example` til `.env`, og angiv derefter tjenesternes adresser og tokens (se [SSH og tokens](SshAndTokens.da)). `.env` indeholder credentials og committes aldrig.
## Kørsel
Start scriptet fra den mappe, der skal indeholde det nye projekt:
```bash
src/create-project.sh # tør kørsel: læser fra værterne, opretter intet
src/create-project.sh --apply # opretter alt efter et sidste ja
```
Der laves ingen commit i det nye projekt. Arbejd på en branch der: frameworkets hooks afviser commits på `main`.
+2
View File
@@ -1,3 +1,5 @@
English | [Dansk](GettingStarted.da) | [Bahasa Melayu](GettingStarted.ms)
# Getting started
## Requirements
+42
View File
@@ -0,0 +1,42 @@
<!-- translation of GettingStarted.md, source sha256 b030cafee29e -->
> Ini ialah terjemahan [`GettingStarted`](GettingStarted). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
[English](GettingStarted) | [Dansk](GettingStarted.da) | Bahasa Melayu
# Bermula
## Keperluan
| Alat | Digunakan untuk |
| --- | --- |
| bash 4.4 atau lebih baharu | skrip (macOS dibekalkan dengan 3.2: pasang bash yang lebih baharu dahulu) |
| `git` | projek tempatan dan submodul framework |
| `curl` | API GitHub dan Gitea |
| `ssh` (pilihan) | semakan SSH; tanpanya langkah framework dilangkau |
| `jq` (pilihan) | penghuraian JSON; tanpanya pembaca terbina dalam yang kecil digunakan |
## Pemasangan
```bash
git clone https://git.tirsystem.com/TirSystem-BashScript/repo-foundry.git
cd repo-foundry
src/create-project.sh --help
```
Tiada apa-apa dipasang pada seluruh sistem: skrip berjalan dari checkout.
## Konfigurasi
Salin `config.env.example` ke `config.env` dan `.env.example` ke `.env`, kemudian tetapkan alamat perkhidmatan dan token (lihat [SSH dan token](SshAndTokens.ms)). `.env` mengandungi kelayakan (credentials) dan tidak pernah di-commit.
## Larian
Mulakan skrip dari folder yang akan menyimpan projek baharu:
```bash
src/create-project.sh # larian percubaan: membaca dari hos, tidak mencipta apa-apa
src/create-project.sh --apply # mencipta semuanya selepas ya terakhir
```
Tiada commit dibuat dalam projek baharu. Bekerja pada branch di sana: hook framework menolak commit pada `main`.
+27
View File
@@ -0,0 +1,27 @@
<!-- translation of Home.md, source sha256 3ab3ef0f5a55 -->
> Dette er en oversættelse af [`Home`](Home). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.
[English](Home) | Dansk | [Bahasa Melayu](Home.ms)
# Repo Foundry
Repo Foundry (`src/create-project.sh`) opretter et nyt projekt i én kørsel:
- et **Gitea**-repository, som er den autoritative kilde;
- eventuelt et tomt **GitHub**-repository, der får alt via et push-spejl fra Gitea;
- et **lokalt projekt** med én remote uden credentials, `origin`, og SQA-QC-Framework som git-submodul, med dets skills, git-hooks og skabeloner installeret.
Det er et Bash-script. Det viser først en plan og opretter intet, før du angiver `--apply` og svarer ja.
## Sider
| Side | Hvad den dækker |
| --- | --- |
| [Kom godt i gang](GettingStarted.da) | Krav, installation og første kørsel |
| [SSH og tokens](SshAndTokens.da) | SSH-adgang til Gitea og de to adgangstokens |
| [Opdatering af frameworket](UpdatingTheFramework.da) | Hold et projekts framework-submodul opdateret |
| [Fejlfinding](Troubleshooting.da) | Almindelige fejl og hvad du skal gøre |
Den fulde reference (konfigurationsfiler, sikkerhedsbeslutninger, fejlhåndtering, kendte begrænsninger) er [README](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md).
Meld et problem som en [issue](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/issues).
+2
View File
@@ -1,3 +1,5 @@
English | [Dansk](Home.da) | [Bahasa Melayu](Home.ms)
# Repo Foundry
Repo Foundry (`src/create-project.sh`) sets up a new project in one run:
+27
View File
@@ -0,0 +1,27 @@
<!-- translation of Home.md, source sha256 3ab3ef0f5a55 -->
> Ini ialah terjemahan [`Home`](Home). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
[English](Home) | [Dansk](Home.da) | Bahasa Melayu
# Repo Foundry
Repo Foundry (`src/create-project.sh`) menyediakan projek baharu dalam satu larian:
- repositori **Gitea**, iaitu sumber yang sah;
- secara pilihan repositori **GitHub** kosong yang menerima semuanya melalui push mirror dari Gitea;
- **projek tempatan** dengan satu remote tanpa kelayakan (credentials), `origin`, dan SQA-QC-Framework sebagai submodul git, dengan skill, git hook dan templatnya terpasang.
Ia ialah skrip Bash. Ia memaparkan pelan dahulu dan tidak mencipta apa-apa sehingga anda memberikan `--apply` dan menjawab ya.
## Halaman
| Halaman | Kandungan |
| --- | --- |
| [Bermula](GettingStarted.ms) | Keperluan, pemasangan dan larian pertama |
| [SSH dan token](SshAndTokens.ms) | Akses SSH ke Gitea dan dua token akses |
| [Mengemas kini framework](UpdatingTheFramework.ms) | Pastikan submodul framework projek sentiasa terkini |
| [Diagnosis](Troubleshooting.ms) | Kegagalan lazim dan tindakan yang perlu diambil |
Rujukan penuh (fail konfigurasi, keputusan keselamatan, pengendalian ralat, had yang diketahui) ialah [README](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md).
Laporkan masalah sebagai [issue](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/issues).
+31
View File
@@ -0,0 +1,31 @@
<!-- translation of SshAndTokens.md, source sha256 52d740c096c8 -->
> Dette er en oversættelse af [`SshAndTokens`](SshAndTokens). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.
[English](SshAndTokens) | Dansk | [Bahasa Melayu](SshAndTokens.ms)
# SSH og tokens
## SSH-adgang til Gitea
Framework-submodulet hentes over SSH på port **10022**. Før du kører scriptet:
1. Tilføj din offentlige SSH-nøgle til din Gitea-konto.
2. Opret forbindelse én gang manuelt, så serverens hostnøgle er kendt (scriptet afviser ukendte hostnøgler):
```bash
ssh -p 10022 -T git@git.tirsystem.com
```
En besked om, at du er godkendt, uden shell-adgang, betyder, at det virker.
> **Nøgler med adgangskode.** Scriptet beder aldrig om en adgangskode. En nøgle med adgangskode skal allerede være indlæst i `ssh-agent` (`ssh-add`). Det følges i [issue 77](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/issues/77).
## Tokens
| Token | Nøgle i `.env` | Nødvendig | Type |
| --- | --- | --- | --- |
| Gitea-adgangstoken | `GITEA_TOKEN` | altid | adgangstoken med scopes |
| GitHub personal access token | `GITHUB_PAT` | kun hvis du vælger GitHub | **klassisk** personal access token |
Trin for trin med billeder: [sådan opretter du adgangstokens](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/howto/create-access-tokens.md). De præcise tilladelser står under [Token permissions](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#token-permissions) i README.
+2
View File
@@ -1,3 +1,5 @@
English | [Dansk](SshAndTokens.da) | [Bahasa Melayu](SshAndTokens.ms)
# SSH and tokens
## SSH access to Gitea
+31
View File
@@ -0,0 +1,31 @@
<!-- translation of SshAndTokens.md, source sha256 52d740c096c8 -->
> Ini ialah terjemahan [`SshAndTokens`](SshAndTokens). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
[English](SshAndTokens) | [Dansk](SshAndTokens.da) | Bahasa Melayu
# SSH dan token
## Akses SSH ke Gitea
Submodul framework diambil melalui SSH pada port **10022**. Sebelum anda menjalankan skrip:
1. Tambahkan kunci awam SSH anda ke akaun Gitea anda.
2. Sambung sekali secara manual supaya kunci hos pelayan dikenali (skrip menolak kunci hos yang tidak dikenali):
```bash
ssh -p 10022 -T git@git.tirsystem.com
```
Mesej bahawa anda telah berjaya disahkan, tanpa akses shell, bermakna ia berfungsi.
> **Kunci dengan frasa laluan.** Skrip tidak pernah meminta frasa laluan. Kunci dengan frasa laluan mesti sudah dimuatkan dalam `ssh-agent` (`ssh-add`). Perkara ini dijejaki dalam [issue 77](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/issues/77).
## Token
| Token | Kunci dalam `.env` | Diperlukan | Jenis |
| --- | --- | --- | --- |
| Token akses Gitea | `GITEA_TOKEN` | sentiasa | token akses dengan skop |
| GitHub personal access token | `GITHUB_PAT` | hanya jika anda memilih GitHub | personal access token **klasik** |
Langkah demi langkah dengan gambar: [cara mencipta token akses](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/howto/create-access-tokens.md). Kebenaran yang tepat terdapat di bawah [Token permissions](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#token-permissions) dalam README.
+16
View File
@@ -0,0 +1,16 @@
<!-- translation of Troubleshooting.md, source sha256 da17de6a5d61 -->
> Dette er en oversættelse af [`Troubleshooting`](Troubleshooting). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.
[English](Troubleshooting) | Dansk | [Bahasa Melayu](Troubleshooting.ms)
# Fejlfinding
| Symptom | Hvad du skal kontrollere |
| --- | --- |
| Planen siger, at SSH-testen mislykkedes | Din nøgle er i din Gitea-konto, hostnøglen er kendt (`ssh -p 10022 -T git@git.tirsystem.com`), og en nøgle med adgangskode er indlæst med `ssh-add` |
| Scriptet stopper ved værktøjskontrollen | bash er 4.4 eller nyere, og `git` og `curl` er installeret |
| En vært afviser tokenet | Tokenet er gyldigt og har de scopes, der står under [SSH og tokens](SshAndTokens.da) |
| En kørsel stoppede undervejs | Ret årsagen og kør den samme kommando igen med `--apply`: det, der allerede er oprettet, tilbydes genbrugt |
Mere: [Error handling and recovery](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#error-handling-and-recovery) og [Known limitations](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#known-limitations) i README.
+2
View File
@@ -1,3 +1,5 @@
English | [Dansk](Troubleshooting.da) | [Bahasa Melayu](Troubleshooting.ms)
# Troubleshooting
| Symptom | What to check |
+16
View File
@@ -0,0 +1,16 @@
<!-- translation of Troubleshooting.md, source sha256 da17de6a5d61 -->
> Ini ialah terjemahan [`Troubleshooting`](Troubleshooting). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
[English](Troubleshooting) | [Dansk](Troubleshooting.da) | Bahasa Melayu
# Diagnosis
| Gejala | Perkara yang perlu disemak |
| --- | --- |
| Pelan menyatakan ujian SSH gagal | Kunci anda ada dalam akaun Gitea anda, kunci hos dikenali (`ssh -p 10022 -T git@git.tirsystem.com`), dan kunci dengan frasa laluan dimuatkan dengan `ssh-add` |
| Skrip berhenti pada semakan alat | bash ialah 4.4 atau lebih baharu, dan `git` serta `curl` dipasang |
| Hos menolak token | Token masih sah dan mempunyai skop yang disenaraikan dalam [SSH dan token](SshAndTokens.ms) |
| Larian berhenti separuh jalan | Betulkan puncanya dan jalankan arahan yang sama sekali lagi dengan `--apply`: apa yang telah dicipta ditawarkan untuk digunakan semula |
Lagi: [Error handling and recovery](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#error-handling-and-recovery) dan [Known limitations](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#known-limitations) dalam README.
+64
View File
@@ -0,0 +1,64 @@
<!-- translation of UpdatingTheFramework.md, source sha256 3e450f6c8f34 -->
> Dette er en oversættelse af [`UpdatingTheFramework`](UpdatingTheFramework). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.
[English](UpdatingTheFramework) | Dansk | [Bahasa Melayu](UpdatingTheFramework.ms)
# Opdatering af frameworket
Et projekt oprettet af Repo Foundry har SQA-QC-Framework som git-submodulet `framework`. En clone eller en `git pull` flytter det ikke: projektet bliver på den framework-commit, det har registreret. For at holde frameworket opdateret kører du dette i projektet, fra dets rod:
```bash
git submodule update --init --remote --recursive framework
```
| Del | Hvorfor |
| --- | --- |
| `--init` | henter submodulet, hvis det ikke findes endnu |
| `--remote` | flytter `framework` til den nyeste commit i framework-repositoryet i stedet for den commit, projektet har registreret |
| `--recursive` | opdaterer også det submodul, frameworket selv har (`framework/qc`, checklisterne) |
## Efter opdateringen
1. Installér skills igen, så kopierne i `.claude/skills/` og `.agents/skills/` svarer til det nye framework:
```bash
bash framework/scripts/install-skills.sh
```
2. Gennemgå, hvad der er ændret, og commit derefter den nye framework-commit på en branch (frameworkets hooks afviser commits på `main`):
```bash
git status
git switch -c update-framework
git add framework
git commit -m "Update the framework"
```
3. Opdatér `AGENTS.md` (næste afsnit).
## Opdatér AGENTS.md til den nyeste skabelon
`AGENTS.md` i dit projekt blev kopieret fra `framework/templates/AGENTS-template.md`, da projektet blev oprettet. Det er en kopi, så den ændres ikke, når frameworket ændres. Skabelonen indeholder de regler, frameworkets skills og hooks forventer (for eksempel superviseret og autonom tilstand), så opdatér den efter hver framework-opdatering.
1. Se, hvad der er forskelligt:
```bash
diff -u AGENTS.md framework/templates/AGENTS-template.md
```
2. Hvis du aldrig har redigeret `AGENTS.md`, erstat den:
```bash
cp framework/templates/AGENTS-template.md AGENTS.md
```
3. Hvis du har tilføjet egne regler, kopiér de nye eller ændrede skabelonafsnit ind i `AGENTS.md` i hånden og behold dine egne. Hvis du erstatter filen, mister du dem.
Repo Foundry lægger `/AGENTS.md` i `.git/info/exclude` i det nye projekt, så git ikke viser filen, og ændringen er ikke en commit: den påvirker kun din arbejdskopi. Erstat ikke `docs/artifact-registry.md` på samme måde: den indeholder dit projekts egne rækker, så sammenlign den kun med `framework/templates/artifact-registry-template.md` og kopiér det, du har brug for.
## Noter
- `--remote` følger framework-repositoryets standardbranch, ikke et release-tag. For at blive på et release skal du i stedet checke tagget ud i submodulet: `git -C framework checkout <tag>`, og derefter committe `framework` som ovenfor.
- En anden person, der clone'r projektet eller henter din commit, får den registrerede framework-commit med `git submodule update --init --recursive`.
- Submodulet hentes over SSH på port 10022, så [SSH-opsætningen](SshAndTokens.da) gælder også for opdateringer.
+3 -1
View File
@@ -1,3 +1,5 @@
English | [Dansk](UpdatingTheFramework.da) | [Bahasa Melayu](UpdatingTheFramework.ms)
# Updating the framework
A project created by Repo Foundry holds the SQA-QC-Framework as the git submodule `framework`. A clone or a `git pull` does not move it: the project stays on the framework commit it recorded. To keep the framework up to date, run this in the project, from its root:
@@ -49,7 +51,7 @@ git submodule update --init --remote --recursive framework
3. If you added your own rules, copy the new or changed template sections into `AGENTS.md` by hand and keep yours. Replacing the file would lose them.
Repo Foundry adds `/AGENTS.md` to `.git/info/exclude` in the new project, so git does not list the file and the change is not a commit: it only affects your working copy. Do not do the same with `docs/artifact-registry.md`: it holds your project's own rows, so only compare it with `framework/templates/artifact-registry-template.md` and copy what you need.
Repo Foundry adds `/AGENTS.md` to `.git/info/exclude` in the new project, so git does not list the file and the change is not a commit: it only affects your working copy. Do not replace `docs/artifact-registry.md` the same way: it holds your project's own rows, so only compare it with `framework/templates/artifact-registry-template.md` and copy what you need.
## Notes
+64
View File
@@ -0,0 +1,64 @@
<!-- translation of UpdatingTheFramework.md, source sha256 3e450f6c8f34 -->
> Ini ialah terjemahan [`UpdatingTheFramework`](UpdatingTheFramework). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
[English](UpdatingTheFramework) | [Dansk](UpdatingTheFramework.da) | Bahasa Melayu
# Mengemas kini framework
Projek yang dicipta oleh Repo Foundry menyimpan SQA-QC-Framework sebagai submodul git `framework`. Clone atau `git pull` tidak menggerakkannya: projek kekal pada commit framework yang direkodkannya. Untuk memastikan framework sentiasa terkini, jalankan ini dalam projek, dari akarnya:
```bash
git submodule update --init --remote --recursive framework
```
| Bahagian | Sebab |
| --- | --- |
| `--init` | mengambil submodul jika ia belum ada |
| `--remote` | menggerakkan `framework` ke commit terkini repositori framework, bukannya commit yang direkodkan oleh projek |
| `--recursive` | turut mengemas kini submodul yang dimiliki framework sendiri (`framework/qc`, senarai semak) |
## Selepas kemas kini
1. Pasang semula skill, supaya salinan dalam `.claude/skills/` dan `.agents/skills/` sepadan dengan framework baharu:
```bash
bash framework/scripts/install-skills.sh
```
2. Semak apa yang berubah, kemudian commit commit framework baharu pada sebuah branch (hook framework menolak commit pada `main`):
```bash
git status
git switch -c update-framework
git add framework
git commit -m "Update the framework"
```
3. Kemas kini `AGENTS.md` (bahagian seterusnya).
## Kemas kini AGENTS.md kepada templat terkini
`AGENTS.md` dalam projek anda disalin daripada `framework/templates/AGENTS-template.md` semasa projek dicipta. Ia ialah salinan, jadi ia tidak berubah apabila framework berubah. Templat itu mengandungi peraturan yang dijangka oleh skill dan hook framework (contohnya mod diselia dan mod autonomi), jadi kemas kininya selepas setiap kemas kini framework.
1. Lihat apa yang berbeza:
```bash
diff -u AGENTS.md framework/templates/AGENTS-template.md
```
2. Jika anda tidak pernah mengedit `AGENTS.md`, gantikannya:
```bash
cp framework/templates/AGENTS-template.md AGENTS.md
```
3. Jika anda menambah peraturan sendiri, salin bahagian templat yang baharu atau berubah ke dalam `AGENTS.md` secara manual dan kekalkan peraturan anda. Menggantikan fail akan menghilangkannya.
Repo Foundry menambah `/AGENTS.md` ke `.git/info/exclude` dalam projek baharu, jadi git tidak menyenaraikan fail itu dan perubahan itu bukan commit: ia hanya memberi kesan kepada salinan kerja anda. Jangan gantikan `docs/artifact-registry.md` dengan cara yang sama: ia mengandungi baris projek anda sendiri, jadi bandingkannya sahaja dengan `framework/templates/artifact-registry-template.md` dan salin apa yang anda perlukan.
## Nota
- `--remote` mengikuti branch lalai repositori framework, bukan tag keluaran. Untuk kekal pada keluaran, checkout tag di dalam submodul: `git -C framework checkout <tag>`, kemudian commit `framework` seperti di atas.
- Orang lain yang meng-clone projek, atau menarik commit anda, mendapat commit framework yang direkodkan dengan `git submodule update --init --recursive`.
- Submodul diambil melalui SSH pada port 10022, jadi [persediaan SSH](SshAndTokens.ms) juga terpakai untuk kemas kini.
+20
View File
@@ -1,5 +1,25 @@
**Repo Foundry**
**English**
- [Home](Home)
- [Getting started](GettingStarted)
- [SSH and tokens](SshAndTokens)
- [Updating the framework](UpdatingTheFramework)
- [Troubleshooting](Troubleshooting)
**Dansk**
- [Hjem](Home.da)
- [Kom godt i gang](GettingStarted.da)
- [SSH og tokens](SshAndTokens.da)
- [Opdatering af frameworket](UpdatingTheFramework.da)
- [Fejlfinding](Troubleshooting.da)
**Bahasa Melayu**
- [Utama](Home.ms)
- [Bermula](GettingStarted.ms)
- [SSH dan token](SshAndTokens.ms)
- [Mengemas kini framework](UpdatingTheFramework.ms)
- [Diagnosis](Troubleshooting.ms)