diff --git a/docs/ai-context.md b/docs/ai-context.md index 41dd103..0047e28 100644 --- a/docs/ai-context.md +++ b/docs/ai-context.md @@ -1,6 +1,6 @@ # AI Context: Gitea Actions CI -kirjasto -**Updated**: 2026-06-15 (siivottu, provider/consumer-erottelu valmis) +**Updated**: 2026-06-19 (provider/consumer dual role, Project Skills -aktivointi) ## Project Overview Gitea Actions reusable workflow -kirjasto mikropalveluiden build-, testaus-, @@ -11,8 +11,8 @@ käyttävät kirjastoa `uses:`-direktiivillä. ## Monorepo: kaksi erillistä kokonaisuutta ### 1. Juuri (`gitea-ci-library`) -Provider-kirjasto: reusable workflowt, scriptit, ADRt, dokumentaatio. -Consumer kutsuu provider-workflowta `uses:`-direktiivillä. +Provider- ja consumer-kirjasto: reusable workflowt, scriptit, ADRt, dokumentaatio, +ja consumer-esimerkit (dogfood). Consumer kutsuu provider-workflowta `uses:`-direktiivillä. ### 2. `git-pages/` — oma kokonaisuus Helm-chartti Codeberg git-pagesille. Täysin itsenäinen — oma dokumentaatio, @@ -31,8 +31,8 @@ kuuluu `git-pages/docs/`-alle, ei juuren `docs/`-kansioon. | `scripts/` | Provider-skriptit: `report-status.sh`, `publish-git-pages.sh`, `ci-validate.sh` | | `.gitea/scripts/` | **Consumer-skriptit**: `bats-coverage.sh`, `bats-report.sh` | | `docs/` | Arkkitehtuuri, ADRt (0004–0008) | -| `skills/consumer-pipelines/` | Consumer-pipeline-standardit — AI:n pakottavat säännöt consumer-CI:lle | -| `skills/ci-container-build/` | CI-kontin build-workflow'n template — `ci-container-build-push.yml` | +| `skills/consumer-pipelines/` | Consumer-pipeline-standardit (ks. Project Skills). Koskee vain consumer-puolta | +| `skills/ci-container-build/` | CI-kontin build-workflow'n template (ks. Project Skills) | | `docs/adr/` | Architecture Decision Records | | `git-pages/` | Raporttien hostaus (Helm-chartti) | | `tests/` | Bats-testit skripteille | @@ -57,9 +57,28 @@ kuuluu `git-pages/docs/`-alle, ei juuren `docs/`-kansioon. | `example-cucumber-tests.yml` | workflow_call | Hyväksymätestit Cucumberilla, raportit git-pagesiin, status linkillä | | `example-gitea-env.conf` | — | KEY=VALUE config tälle repolle | +## Provider & Consumer Dual Role + +Tämä repo on **yhtä aikaa sekä provider että consumer**. Eri puolilla on eri säännöt: + +- **Provider-puoli**: `.gitea/workflows/*.yml` (pl. `example-*`), `scripts/` — reusable workflowt joita muut projektit kutsuvat. Saa käyttää `docker run` -komentoja (esim. `docker-build-push.yml`). Consumer-pipeline-standardit (`skills/consumer-pipelines/`) eivät koske provideria. +- **Consumer-puoli**: `.gitea/workflows/example-*`, `.gitea/scripts/` — tämän repon oma CI (dogfood), toimii consumer-esimerkkinä. Käyttää `@main`-refiä provider-viittauksissa (sama repo). Noudattaa `skills/consumer-pipelines/`-sääntöjä. +- **Ulkoiset consumerit** käyttävät `@v1`-tagia provider-viittauksissa. + +## Project Skills (skills/) + +Tämä projekti sisältää omia `.ai/skills/`-järjestelmästä riippumattomia skillejä `skills/`-kansiossa. Jokainen alihakemisto sisältää `SKILL.md`:n jossa on `activation-gate`-kenttä. + +**Sääntö:** Uuden tehtävän alussa skannaa `skills/*/SKILL.md` ja arvioi jokaisen `activation-gate` annettua tehtävää vasten. Jos gate matchaa, lataa skill aktiiviseksi ohjeeksi ennen toimenpiteitä. + +| Skill | Gate | Kuvaus | +|---|---|---| +| `skills/consumer-pipelines/` | Consumer-pipeline-muutokset | Consumer-pipeline-standardit: reitittimen puhtaus, exit-koodi, konttipolitiikka, raportointi, nimeäminen. Koskee vain consumer-puolta. | +| `skills/ci-container-build/` | CI-kontin build | CI-kontin build-workflown template ja Dockerfile-ohjeet | + ## Key Technical Decisions -- **Provider & Consumer -malli**: `example-*`-tiedostot ovat consumer-esimerkkejä, provider-workflowt reusableja. ADR 0005. +- **Provider & Consumer -malli**: Tämä repo on sekä provider että consumer. Provider-workflowt reusableja muille, `example-*`-tiedostot tämän repon oma consumer-CI (dogfood). ADR 0005. - **Vain Gitea, vain reusable workflowt**: ei custom actioneita, ei multi-platform - **Commit-status API vain raporttilinkeille**: Tool-jobit luottavat natiiviin. Test-jobit käyttävät API:a koska se on ainoa tapa upottaa raporttilinkki. ADR 0004, 0007. - **Exit-koodi on ainoa onnistumisen mittari**: Ei pipeä, ei tiedostoheuristiikkaa. ADR 0008. diff --git a/docs/tech-stack.md b/docs/tech-stack.md index 94ff569..3c0d2fd 100644 --- a/docs/tech-stack.md +++ b/docs/tech-stack.md @@ -38,4 +38,4 @@ suoraan Gitea UI:ssa. | **Multi-Git-platform** | Vain Gitea — yksi alusta kunnolla (periaate 10) | | **Custom actionit** | Reusable workflow on kevyempi ja natiivimpi (periaate 2) | | **Ulkoinen orkestraattori** | Gitean `needs` + `if` hoitaa ohjauksen | -| **Artifactory/Nexus** | Gitea Packages riittää MVP:ssä | +| **Artifactory/Nexus** | Build & push toimii Docker-standardilla. UI-tason linkitys (`report-summary`) vaatii Nexus/Artifactory-spesifin URL-rakenteen — ei vielä toteutettu, toteutetaan tarvittaessa |