Compare commits

...
Author SHA1 Message Date
codex ff87584980 Correct shell guard for every workflow runner label
CI / tests-and-images (pull_request) Waiting to run
Runner smoke test / runner-smoke (pull_request) Waiting to run
2026-11-21 20:27:46 +00:00
codex f2c5cf80fa Route AkylDash Actions to its isolated local Docker Desktop runner
CI / tests-and-images (pull_request) Canceled after 0s
Runner smoke test / runner-smoke (pull_request) Canceled after 0s
2026-11-21 20:26:25 +00:00
agent 43f52ced20 Merge pull request 'Перевести проектные инструкции на Windows Codex и Gitea MCP' (#65) from fix/windows-mcp-instructions into main
CI / tests-and-images (push) Successful in 2m29s
Runner smoke test / runner-smoke (push) Successful in 2s
2026-11-15 19:57:43 +00:00
codex 7f8f6cd297 docs: зафиксировать переход инструкций на Gitea MCP в changelog
CI / tests-and-images (pull_request) Successful in 2m40s
Runner smoke test / runner-smoke (pull_request) Successful in 4s
2026-11-15 18:55:56 +00:00
codex 2a30def397 docs: устранить конфликтующие инструкции по результатам ревью
CI / tests-and-images (pull_request) Successful in 3m1s
Runner smoke test / runner-smoke (pull_request) Successful in 4s
2026-11-15 18:51:41 +00:00
codex d3f5b2b9d1 docs: перейти на Windows Codex и Gitea MCP
CI / tests-and-images (pull_request) Successful in 2m59s
Runner smoke test / runner-smoke (pull_request) Successful in 3s
2026-11-15 18:48:53 +00:00
agent 871bde1abd Merge pull request 'fix: enumerate Windows ACL entries by SID' (#63) from fix/windows-acl-sid-enumeration into main
CI / tests-and-images (push) Successful in 2m12s
Runner smoke test / runner-smoke (push) Successful in 2s
2026-11-03 09:11:40 +00:00
15 changed files with 159 additions and 125 deletions

No files matched your search

+1 -1
View File
@@ -7,7 +7,7 @@ on:
jobs:
tests-and-images:
runs-on: akyldash-ci
runs-on: akyldash-local-ci
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
+1 -1
View File
@@ -13,7 +13,7 @@ jobs:
gitea.event.workflow_run.conclusion == 'success' &&
gitea.event.workflow_run.event == 'workflow_run' &&
gitea.event.workflow_run.head_branch == 'main'
runs-on: akyldash-ci
runs-on: akyldash-local-ci
steps:
- uses: actions/checkout@v4
with:
+1 -1
View File
@@ -12,7 +12,7 @@ jobs:
gitea.event.workflow_run.conclusion == 'success' &&
gitea.event.workflow_run.event == 'push' &&
gitea.event.workflow_run.head_branch == 'main'
runs-on: akyldash-ci
runs-on: akyldash-local-ci
steps:
- uses: actions/checkout@v4
with:
+1 -1
View File
@@ -8,7 +8,7 @@ on:
jobs:
runner-smoke:
runs-on: akyldash-ci
runs-on: akyldash-local-ci
steps:
- name: Verify isolated runner boundary
run: |
+30 -70
View File
@@ -1,24 +1,18 @@
# Акылдаш — инструкции для агента
Проект: юридическая информационно-аналитическая платформа; Search API на
Python, SQLite и OpenSearch. На 2026-10-25 публичный `/review` и прямой origin
отвечают HTTP 200; состав production-контейнеров, готовность индекса и
проверенность backup/restore не подтверждены. Сверяй актуальное состояние с
[`CURRENT_STATE.md`](docs/operations/CURRENT_STATE.md), не считай HTTP 200
доказательством готовности поиска.
- Начинай с [инфраструктурного состояния](docs/operations/CURRENT_STATE.md) и
[правил доступа](docs/operations/ACCESS.md). Не запрашивай доступы повторно.
Python, SQLite и OpenSearch. Для инфраструктурных задач используй Skill
`commerce-infra`, контур `commerce`, проект `akyldash`. Сверяй состояние с
[`CURRENT_STATE.md`](docs/operations/CURRENT_STATE.md) и
[правилами доступа](docs/operations/ACCESS.md). HTTP 200 сам по себе не
подтверждает готовность индекса или восстановимость данных.
- Архитектура и процедуры: [инфраструктура](docs/operations/INFRASTRUCTURE.md),
[деплой](docs/operations/DEPLOYMENT.md), [backup](docs/operations/BACKUP.md),
[rollback](docs/operations/ROLLBACK.md), [восстановление](docs/operations/RECOVERY.md).
- Работай в feature/fix/refactor-ветке. `main` защищена; изменения вноси через
PR. DEV не одобряет и не сливает собственный PR. Условный merge выполняет
только REVIEWER по правилам раздела «Автономный workflow PR» ниже. Сохраняй
незакоммиченные изменения.
- SSH alias — `akyldash_vps`; используй только read-only диагностику. Не давай
`codex` общий sudo или доступ к Docker socket. Root-действия требует владелец.
Для Gitea используй `gitea-api`, не читай файлы с учётными данными.
- `main` защищена. Изменения проходят через PR по правилам ниже.
- Доступ к VPS для диагностики ограничен read-only. Не давай серверному
пользователю `codex` общий sudo или доступ к Docker socket. Root-действия
выполняет владелец.
- Репозиторный Gitea Actions runner описан в
[CI_RUNNER.md](docs/operations/CI_RUNNER.md). Регистрация выполняется
владельцем через Settings → Actions → Runners для `admin/akyldash`; токен
@@ -66,59 +60,25 @@ Python, SQLite и OpenSearch. На 2026-10-25 публичный `/review` и п
- Полная процедура, метрики, Gitea-ограничения и проверенные временные бюджеты:
[DELIVERY_POLICY.md](docs/development/DELIVERY_POLICY.md).
## Автономный workflow PR
## Согласование изменений
- Маршруты ниже указаны из контекста оркестратора/root: оркестратор — thread
`01a144a5-8b95-77c3-b311-9a9afd062ca8`, host `local`; DEV — thread
`01a138f1-3b34-7c91-a9ed-4b43c3c85f1f`, host
`remote-ssh-codex-managed:712b8d4e-24e1-4dd5-92af-85d1fbd26449`, Gitea
`codex` (ID 6); REVIEWER — thread `01a144f9-5b51-7923-8398-61d4a6a98306`,
host `remote-ssh-codex-managed:b61555d7-8d1a-4cfa-988b-c8da4791d426`, Gitea
`agent` (ID 7). Если этот же чат отображает REVIEWER как `local` внутри его
собственного app-server, это self-label и не является маршрутом из контекста
оркестратора.
- DEV принимает только явно зарегистрированную оркестратором человеческую
задачу с полями `task`, `repo`, `branch`, `pr`, `head_sha`, `phase`. Репозиторий
должен быть `admin/akyldash`; работай только в назначенной ветке и PR. Веди
одну задачу/PR за раз и не подхватывай старые PR самостоятельно.
- Допустимые фазы: `initial_review` — реализация и устранение review findings;
`final_review_and_merge` — только после первоначального успешного review,
changelog-коммита и отдельного назначения оркестратора. Не переходи к следующей
фазе без назначения. Если задача приостановлена, останови любые действия;
после resume перепроверь назначение, PR, head/base, checks и review с нуля.
- Повторная доставка одного назначения идемпотентна по ключу
`task`+`pr`+`head_sha`+`stage`: не дублируй commit, push, review-запрос или
merge; сообщи оркестратору о уже выполненном результате. Новый head или stage
образует новое назначение и требует повторной проверки.
- Межчатовое чтение недоступно: оркестратор через central relay сам читает
результаты и выдаёт назначения. Завершай каждый этап отчётом с полями `task`,
`repo`, `branch`, `pr`, `head_sha`, `stage`, `checks`, `findings`,
`next_action`. Не настраивай отдельные webhook, daemon или транспорт.
- DEV исследует, изменяет, проверяет, коммитит и отправляет изменения; REVIEWER
не меняет код и независимо проверяет полный diff от base после каждого push,
включая предыдущие findings. DEV не одобряет и не сливает свой PR.
- Только после первоначального успешного формального review DEV добавляет
значимые изменения в существующий changelog, коммитит и отправляет их в тот же
PR. Затем REVIEWER полностью проверяет итоговый diff. Для docs-only задачи не
придумывай изменения кода; правила версии применяй только если они явно
относятся к этой документационной правке.
- Слияние может выполнить только REVIEWER для зарегистрированной человеческой
задачи, в фазе `final_review_and_merge`, после явного назначения оркестратора.
Непосредственно перед ним REVIEWER подтверждает `admin/akyldash`, PR, base
`main`, ожидаемую ветку, автора PR `codex` (ID 6), неизменность base и head,
причём head должен совпадать с зарегистрированным `head_sha`, включая
`head_commit_id` для merge-запроса. Требуются все успешные required CI/test
checks и gates, отсутствие pending/failed/unknown checks, открытых
findings и активных `REQUEST_CHANGES`, плюс актуальный формальный `APPROVED`
от REVIEWER для точного текущего commit с параметрами `commit_id == head_sha`,
`stale == false`, `dismissed == false`. При изменении head или base review и
проверки выполняются заново. Комментарий с approval не является формальным
review.
Используй только обычный server-side merge с `head_commit_id`; не используй
`force_merge` и не обходи branch protection. Если любой существенный gate,
статус или защита неизвестны либо не проверяются — не сливай PR и сообщи
оркестратору, что именно осталось неизвестным.
- Все Gitea API-вызовы выполняй только через `gitea-api` с личным окружением;
Git используй с обычным credential helper. Не читай credentials из файлов
репозитория. Запускай Git- и API-команды отдельно, без объединения с другими
командами.
- Создавай ветку от актуальной `main`, коммиты и PR через Gitea Codex MCP.
Обновления вноси в тот же PR. Автор не одобряет и не сливает свой PR.
- После каждого push отдельный ревьюер проверяет полный diff относительно
base и ранее найденные дефекты. Формальное ревью публикуется через Gitea
Agent MCP. Разные учётные записи обеспечивают разделение полномочий.
Независимость требует отдельного исполнителя ревью.
- После первого успешного ревью и CI внеси значимое изменение в существующий
changelog и отправь коммит в тот же PR. Повтори полное ревью итогового diff
и CI. Для docs-only задачи версию приложения повышай только при явном
требовании к этой правке.
- Merge через Gitea Agent MCP допускается после независимого ревью и только
при явном разрешении владельца репозитория. Перед слиянием проверь `admin/akyldash`, номер PR, автора `codex`, base
`main`, ожидаемую ветку и точные SHA head/base. Нужны все успешные
обязательные checks и gates, отсутствие открытых блокеров и действующих
`REQUEST_CHANGES`, формальный `APPROVED` от `agent` с
`commit_id == head_sha`, `stale == false` и `dismissed == false`.
При изменении head или base повтори проверки и ревью. Используй обычный
server-side merge с `head_commit_id`, без force и обхода branch protection.
При неизвестном, ожидающем или неуспешном обязательном условии оставь PR
открытым и укажи причину.
+3
View File
@@ -2,6 +2,9 @@
## Не выпущено
- Документация: инструкции Акылдаша переведены на нативный Windows Codex,
`commerce-infra` и Gitea MCP. Сохранены независимое ревью, обязательные
CI-проверки, одобрение текущего head и ограничения production-доступа.
- Deployment: подготовлен внешний handoff для Windows-клиента от точного Gitea
commit. Bundle фиксирует commit/tree/blob identity и SHA-256; installer
проверяет bundle и ACL до записи и не запускает Git. Bootstrap на release A
+5 -8
View File
@@ -50,11 +50,7 @@
и проверяет runtime-изоляцию job-контейнера: отсутствие системного и
rootless Docker socket, production env/secrets и host checkout. Smoke дополняет
статические проверки runner/CI и не дублирует их.
- Инфраструктурная конфигурация репозитория закрепляет официальный
`act_runner 0.2.13`, label `akyldash-ci`, capacity 1 и ограничения job 2 CPU,
3 GiB RAM, 512 процессов, 15 GiB store. Версия runner и лимиты приведены по
IaC; в рамках этой задачи VPS не проверялся. Job-контейнеры не должны получать
ни один Docker socket.
- Все задания используют `akyldash-local-ci` в Docker Desktop владельца. Конфигурация `infra/runner/desktop` выделяет заданию 4 CPU, 6 GiB RAM и 512 процессов, capacity 1. Данные внутреннего Docker хранятся в отдельном томе. Job-контейнеры не получают Docker socket.
- Текущая политика `main` из branch API: ветка защищена и требует одного
одобрения. На момент проверки API также сообщил `enable_status_check=false`
и пустой список status contexts. Это PR не меняет branch protection.
@@ -86,7 +82,7 @@ Gitea 1.25 документация подтверждает используе
предположениях:
- `runs-on` поддерживает статическую метку или список меток; текущая
`akyldash-ci` — статическая метка.
`akyldash-local-ci` — статическая метка.
- Выражения доступны ограниченно; в сравнении с GitHub Actions Gitea 1.25
обещает функцию `always()`, поэтому workflow не должен зависеть от
`if:`-выражений для динамического выбора набора тестов по diff или уровню
@@ -173,5 +169,6 @@ regressions и rollback baseline остаются `N/A`, пока не появ
Каждый блокер содержит файл/участок, шаги воспроизведения или точное условие,
последствие и минимальный безопасный fix. Остальные замечания — отдельный
неблокирующий список. Review и approval остаются за людьми; агент не начинает
review сам и не сливает PR.
неблокирующий список. Независимый ревьюер проверяет полный diff и передаёт
результат через Gitea Agent MCP. Формальное одобрение и разрешённый Merge
следуют условиям [AGENTS.md](../../AGENTS.md#согласование-изменений).
+24 -39
View File
@@ -2,20 +2,14 @@
## Discover existing access first
In a new Codex session, inspect the SSH alias and key file metadata without
printing key contents, then check the connection:
For repository work in Windows Codex, use `commerce-infra` to read the
`commerce/akyldash` context through Gitea Infrastructure Registry MCP. Use
Gitea Codex MCP to read the project sources and prepare changes.
Use the repository PR rules for formal review and permitted merge.
```bash
ssh -F ~/.ssh/config -G akyldash_vps | awk '$1 == "hostname" || $1 == "user" || $1 == "port" || $1 == "identityfile" { print }'
test -r ~/.ssh/akyldash_codex && echo 'SSH key is available'
ssh -F ~/.ssh/config -o BatchMode=yes akyldash_vps id
ssh -F ~/.ssh/config -o BatchMode=yes akyldash_vps hostname -f
gitea-api GET /version
gitea-api GET /repos/admin/akyldash
```
Do not ask for the host, login, password, token, or key again before these
checks. Never print a private key, token, or complete environment file.
Host access is needed only for separately authorized runtime diagnostics.
Check the configured SSH alias and key metadata without reading key contents.
Do not request passwords, tokens, or keys, or print a complete environment file.
## VPS
@@ -42,36 +36,27 @@ checks. Never print a private key, token, or complete environment file.
It does not start Compose or create volumes.
- Never connect to other VPS hosts or Synology as part of this deployment.
This execution environment is WSL2. The repository is on the Windows-mounted
`/mnt/d` filesystem, while SSH config and the identity file are in the Linux
home directory. Do not assume Windows SSH credentials are available or copy
keys between environments. Plain `ssh akyldash_vps` failed because the system
SSH config include had unsafe permissions. Use `ssh -F ~/.ssh/config ...`; in a
network-restricted session this read-only command may also require approved
execution. If the key is missing in a future environment, report that
limitation and do not retrieve it elsewhere.
For authorized runtime diagnostics, use the configured read-only SSH access.
Validate the resolved alias, hostname, user and port before connecting. Only
use an existing approved key for this environment. If access is unavailable,
record the limitation. Do not copy keys between environments.
## Gitea
- Repository: `https://git.vakanaut.ru/admin/akyldash`.
- Use the installed `gitea-api` helper; it reads credentials from the
environment. Never inspect local credential files, print environment values,
or construct HTTP authorization headers.
- The audited API token can read/write this repository and create issues, but
does not have `read:user` or `read:package`. Listing repository Actions
runners returns `403` because the API principal is not the repository owner.
An API `403` caused by missing scope/ownership is not evidence that no runner
exists.
- Protected `main` requires one approval. Do not push directly to `main`, merge
automatically, or start a review. Work on a feature branch and use a PR.
- Gitea Actions and package features are enabled for the repository. The Actions
task API currently returns no runs, but runner availability and package
publishing permissions have not been confirmed. The repository-level runner
is prepared by `infra/runner/install-runner.sh`, but is not installed or
registered yet. Only a repository owner may obtain its registration token in
`admin/akyldash` Settings → Actions → Runners; do not use organization or
instance tokens and never put the token in Git, a command argument, or a
report. See [CI_RUNNER.md](CI_RUNNER.md).
- Use Gitea Codex MCP to read the repository, prepare changes in a separate
branch and open the PR. Use Gitea Agent MCP for formal review, approval and
permitted merge according to [AGENTS.md](../../AGENTS.md#согласование-изменений).
Do not inspect credential files, print secret environment values, or construct
authorization headers.
- Protected `main` requires at least one independent approval and the required
CI checks. Direct push to `main` is prohibited. Merge requires the current
head approval and the checks listed in AGENTS.md.
- A `403` can indicate missing scope or owner permissions. It does not establish
runner absence. Only a repository owner may obtain the repository runner
registration token in `admin/akyldash` Settings → Actions → Runners. Do not use
organization or instance tokens or put the token in Git, a command argument,
or a report. See [CI_RUNNER.md](CI_RUNNER.md).
## Who can do what
+11 -1
View File
@@ -1,6 +1,16 @@
# AkylDash Gitea Actions runner
## Scope and isolation
## Local Docker Desktop runner
All four workflows target the repository-scoped label `akyldash-local-ci` on the owner's Windows PC. Use the pinned rootless DinD image and Compose files in `infra/runner/desktop`. This requires Docker Desktop's `desktop-linux` context and the existing Gitea HTTPS proxy on `home-runner_runner`. Registration and Docker data use separate named volumes. The outer container runs privileged for rootless DinD. Jobs receive no host mounts, Docker socket or privileged mode. Capacity is one job with 4 CPUs, 6 GiB memory and 512 processes. Docker data shares the Desktop VM's free disk space.
From PowerShell run `.\infra\runner\desktop\register.ps1` once and enter the repository runner registration token at the hidden prompt. Verify `akyldash-desktop-local` is online and both required PR jobs pass. To pause, use `docker --context desktop-linux compose --project-directory infra/runner/desktop stop runner`; use `up -d runner` to resume with the existing registration and data. Old workflow revisions still request the VPS label. Update outstanding branches before retrying.
## Historical VPS configuration
The remainder records the former VPS installation and its test history. Its label must not be assigned to the local runner. Do not install it for current workflows.
### Scope and isolation
The deployment follows the official [Gitea 1.25 act_runner guide](https://docs.gitea.com/1.25/usage/actions/act-runner/)
for repository-scoped registration. Gitea warns that access to a Docker daemon
+5 -1
View File
@@ -1,5 +1,9 @@
# Infrastructure current state
## Local runner storage — 2026-11-21
The AkylDash Docker Desktop data volume reported 931.6 GiB available. A container using the runner configuration reached Gitea over HTTPS. The dedicated local label is `akyldash-local-ci`. Registration and successful Actions jobs require separate verification in Gitea.
## Windows ACL SID resolution — 2026-11-03
- Read-only PowerShell 5.1 inspection found that display-name conversion of
@@ -459,7 +463,7 @@ Docker state, UFW rule details, and protected file metadata were not verified.
reviewing the checkout; it grants only fixed verification, Compose
`config`/`status`, and guarded rollback commands.
4. After merging the reviewed PR, confirm a subsequent CI and smoke run on
`akyldash-ci`. Image publishing and production deployment remain manual and
`akyldash-local-ci`. Image publishing and production deployment remain manual and
are not part of CI.
5. Test backup/restore and rollback only with synthetic data in an isolated
environment before any production deployment.
+34
View File
@@ -0,0 +1,34 @@
name: akyldash-ci
services:
runner:
image: docker.io/gitea/runner@sha256:f7f06cb66fa54b556e295f51fba4996c41b4ca65a1fbe0b03d650f78e32b9d0f
privileged: true
restart: unless-stopped
cpus: 6
mem_limit: 8g
environment:
CONFIG_FILE: /etc/akyldash-runner.yaml
GITEA_INSTANCE_URL: https://git.vakanaut.ru
DOCKERD_ROOTLESS_ROOTLESSKIT_NET: slirp4netns
DOCKERD_ROOTLESS_ROOTLESSKIT_MTU: "65520"
configs:
- source: runner-config
target: /etc/akyldash-runner.yaml
extra_hosts:
- "git.vakanaut.ru:172.30.243.2"
networks: [gitea]
volumes:
- registration:/data
- docker-data:/home/rootless/.local/share/docker
configs:
runner-config:
file: ./runner.yaml
networks:
gitea:
external: true
name: home-runner_runner
volumes:
registration:
docker-data:
+16
View File
@@ -0,0 +1,16 @@
$ErrorActionPreference = 'Stop'
$compose = @('--context', 'desktop-linux', 'compose', '--project-directory', $PSScriptRoot)
$token = Read-Host 'admin/akyldash repository runner registration token' -AsSecureString
if (!$token.Length) { throw 'Registration token is empty.' }
$buffer = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($token)
try {
[Runtime.InteropServices.Marshal]::PtrToStringBSTR($buffer) |
docker @compose run --rm -T --no-deps --workdir /data --entrypoint /bin/sh runner -ec 'test ! -e /data/.runner && exec gitea-runner --config /etc/akyldash-runner.yaml register --no-interactive --instance https://git.vakanaut.ru --name akyldash-desktop-local --token-file /dev/stdin'
if ($LASTEXITCODE) { throw 'Registration failed or already exists.' }
}
finally {
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($buffer)
$token.Dispose()
}
docker @compose up -d runner
if ($LASTEXITCODE) { throw 'Could not start the registered runner.' }
+17
View File
@@ -0,0 +1,17 @@
log:
level: info
runner:
file: /data/.runner
capacity: 1
labels:
- "akyldash-local-ci:docker://docker.gitea.com/runner-images:ubuntu-24.04"
cache:
enabled: false
container:
docker_host: "-"
privileged: false
valid_volumes: []
options: "--cpus=4 --memory=6g --pids-limit=512 --add-host=git.vakanaut.ru:172.30.243.2"
+1 -1
View File
@@ -5,7 +5,7 @@ workflow=.gitea/workflows/ci.yaml
kaniko_action=.gitea/actions/kaniko-build/action.yml
caddy_action=.gitea/actions/caddy-validate/action.yml
grep -Fq 'runs-on: akyldash-ci' "$workflow"
grep -Fq 'runs-on: akyldash-local-ci' "$workflow"
grep -Fq 'uses: ./.gitea/actions/caddy-validate' "$workflow"
[[ $(grep -Fc 'uses: ./.gitea/actions/kaniko-build' "$workflow") -eq 2 ]]
check_workspace_wiring() {
+9 -1
View File
@@ -63,7 +63,15 @@ grep -Fq 'find-free-subid-range.awk' "$installer"
grep -Fq 'usermod "${subid_args[@]}" "$runner_user"' "$installer"
grep -Fq 'subid_args+=(--add-subuids "$subid_range")' "$installer"
assert_absent 'usermod.*(sudo|docker)|/var/run/docker.sock|/etc/sudoers' "$installer"
grep -Fq 'runs-on: akyldash-ci' .gitea/workflows/runner-smoke.yaml
for workflow in .gitea/workflows/*.yaml; do
labels=$(sed -n 's/^ *runs-on: *//p' "$workflow" | sort -u)
[[ $labels == akyldash-local-ci ]] || { echo "Unexpected runner in $workflow" >&2; exit 1; }
done
desktop=infra/runner/desktop/runner.yaml
grep -Fq 'akyldash-local-ci:docker://docker.gitea.com/runner-images:ubuntu-24.04' "$desktop"
grep -Fq 'docker_host: "-"' "$desktop"
grep -Fxq ' privileged: false' "$desktop"
grep -Fxq ' valid_volumes: []' "$desktop"
grep -Fq 'test ! -S /var/run/docker.sock' .gitea/workflows/runner-smoke.yaml
grep -Fq 'test ! -e /etc/akyldash/production.env' .gitea/workflows/runner-smoke.yaml
grep -Fq 'test ! -e /etc/akyldash/review_secret' .gitea/workflows/runner-smoke.yaml