Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
7320d13
Конфигурации в меню, зависимости с зеркалами, команда /pn deps
overdyn Nov 15, 2026
51568c1
Чистка структуры: модули в core, подпапки, отправка отчётов выключена…
overdyn Nov 15, 2026
aa2c81e
Стиль: константы меню по экранам, понятные имена функций, английские …
overdyn Nov 15, 2026
7dd2431
Переименования: модуль spi, пакеты модуля updates
overdyn Nov 15, 2026
67e48f6
Clean up structure, move state into data/, replace config files with …
overdyn Nov 15, 2026
85e424c
docs: папка идей на будущее, идея про популярные настройки
overdyn Nov 15, 2026
f281669
Настройки библиотеки: переключалка как у языка, список всех часовых п…
overdyn Nov 15, 2026
e03a3c3
refactor: переименование файлов, устранение дублирования, реструктури…
overdyn Nov 16, 2026
cb79228
Добавить PnLoggerBuffer и улучшить систему логирования Bukkit
overdyn Nov 17, 2026
264604f
Слои audiences и proxy, чистка комментариев и правки команд, ссылок и…
overdyn Nov 18, 2026
f2ebd2b
Bungee: разнесение по пакетам и BungeeNetworkServer, правки Bukkit и …
overdyn Nov 18, 2026
06503b7
Новая система действий и требований, удаление Activity API, правки те…
overdyn Nov 18, 2026
0d253a1
Reorganize events into subpackages, add listenOnce, tidy scenarios, r…
overdyn Nov 18, 2026
ab52046
Раскладка пакетов API и ядра, задачи с подзадачами и лагом, выбор сбо…
overdyn Nov 19, 2026
1c3d477
Библиотеки модулей: источники, область загрузки, платформы, диск плаг…
overdyn Nov 20, 2026
0321d47
Ремастер: зависимости с вариантами и maxBytes, меню "Что не хватает",…
overdyn Nov 20, 2026
4055f80
Влить claude/structure-cleanup в next
overdyn Nov 20, 2026
cd2758e
Влить claude/experiment-structure в next
overdyn Nov 20, 2026
c62b2fa
Версия 0.1.0-dev.6, поколение API 2
overdyn Nov 20, 2026
cff8e91
Влить next в main: ремастер, API поколения 2, версия 0.1.0-dev.6
overdyn Nov 20, 2026
3fe4691
Тест часовых поясов не зависит от пояса машины: проверка строки По ум…
overdyn Nov 21, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
10 changes: 5 additions & 5 deletions .github/workflows/native-platforms.yml
Original file line number Diff line number Diff line change
Expand Up @@ -55,20 +55,20 @@ jobs:
PLATFORM: ${{ matrix.platform }}
run: |
$server = Join-Path $PWD 'build/native-software/server.jar'
$args = @('--console=plain', "-PnativeJavaExecutable=$env:SERVER_JAVA")
$gradleArgs = @('--console=plain', "-PnativeJavaExecutable=$env:SERVER_JAVA")
if ($env:PLATFORM -in @('paper', 'folia')) {
$eula = Join-Path $PWD 'build/native-software/eula.txt'
$args += @(':modules:updates:verifyNativeBukkitUpdates', "-PbukkitPlatform=$env:PLATFORM", "-PpaperServerJar=$server", "-PpaperEulaFile=$eula")
$gradleArgs += @(':modules:updates:verifyNativeBukkitUpdates', "-PbukkitPlatform=$env:PLATFORM", "-PpaperServerJar=$server", "-PpaperEulaFile=$eula")
} else {
$args += @(':modules:updates:verifyNativeProxyUpdates', "-PnativePlatform=$env:PLATFORM", "-P$($env:PLATFORM)ServerJar=$server")
$gradleArgs += @(':modules:updates:verifyNativeProxyUpdates', "-PnativePlatform=$env:PLATFORM", "-P$($env:PLATFORM)ServerJar=$server")
}
& ./gradlew @args
& ./gradlew @gradleArgs
if ($LASTEXITCODE -ne 0) { throw 'Native platform acceptance failed' }
- uses: actions/upload-artifact@v4
if: always()
with:
name: native-${{ matrix.platform }}-java${{ inputs.java }}
path: |
modules/core/build/reports/tests/verifyNative*
modules/updates/build/reports/tests/verifyNative*
build/update-catalog-native/**/*.log
if-no-files-found: ignore
6 changes: 4 additions & 2 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,9 @@ jobs:
- name: Build and verify
run: .\gradlew.bat clean check :distribution:build --console=plain

- name: Check binary API compatibility
run: .\gradlew.bat apiCheck --console=plain

- name: Verify release tooling
shell: pwsh
run: ./tools/release/check-release-tools.tests.ps1
Expand All @@ -115,7 +118,7 @@ jobs:
git commit -m "release: $env:RELEASE_VERSION"
if ($LASTEXITCODE -ne 0) { throw 'Release commit failed' }
}
# A re-run after a partial failure may reuse the tag only if it already points at this commit.
# Повторный запуск после сбоя может взять существующий тег, только если он указывает на этот коммит.
$existingTag = git rev-parse -q --verify "refs/tags/v$env:RELEASE_VERSION^{commit}"
if ($LASTEXITCODE -eq 0) {
if ($existingTag -ne (git rev-parse HEAD)) { throw "Tag v$env:RELEASE_VERSION already points at another commit" }
Expand Down Expand Up @@ -148,7 +151,6 @@ jobs:
'--title', "pnLibrary $env:RELEASE_VERSION",
'--notes', $env:RELEASE_NOTES
)
if ($env:RELEASE_VERSION.Contains('-')) { $arguments += '--prerelease' }
& gh @arguments
if ($LASTEXITCODE -ne 0) { throw 'GitHub Release creation failed' }

Expand Down
25 changes: 22 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,16 +49,35 @@
```

## Где что
- `modules/`: api, core, common, runtime-spi, updates, bootstrap, console, features (config, currency, localization).
- `modules/`: api, core, common, spi, updates, bootstrap, console, features (config, currency, localization).
- `platforms/`: bukkit, bungee, velocity, loader.
- `.pnlibrary/releases.json` и `.pnlibrary/changelogs/<версия>.md`: каталог релизов библиотеки.
- `integration/`: инструкция и заготовка `.pnlibrary` для плагинов на pnLibrary.

## Журнал (новое сверху)
Обновляй эту секцию в конце каждой сессии: одна запись, что сделано и что осталось.

### 2026-11-18 (стиль Bungee)
- Продолжен существующий проход Bungee по образцу Velocity: упрощены сборка рантайма и зависимости, команды используют общий адаптер аудитории; серверный адаптер вынесен в `network/BungeeNetworkServer.kt`. Убраны внутренние KDoc-пересказы и лишние импорты, сохранены пояснения ограничений Bungee. Ранее начатые переносы пакетов сохранены.
- Проверено: 13 тестов Bungee, проверки модулей Bungee и сборка `distribution` прошли. Общий `apiCheck` падает на существующем расхождении `modules/api` (ChatTone, PnLogger, NetworkProxy); публичный API в этой сессии не менялся. Общий `spotlessCheck` также выявил нарушения форматирования за пределами Bungee. На живом прокси не проверялось.

### 2026-11-10 (ошибки, безопасность, скорость)
- Ошибки: около 36 мест, где сбой пропадал молча, теперь пишут в логгер; `ERROR` без исключения уходит в FastStats (временное исключение). Не закрыто: в FastStats идёт `RuntimeException("тип: сообщение")` вместо исходного, нет повторной отправки.
- Безопасность: права проверяет получатель связи (`MenuDataServer.holds`), `link.key` 600, хосты скачивания (`TrustedHosts`), каталог релизов raw/API раньше jsDelivr, битые журналы пропускаются, `@ConfigSecret` в списках и картах. Не сделано: подпись запроса связи платформой-источником, таймаут `policy.check`, общий таймаут скачивания. Хеш политики не возвращали (пользователь убрал).
- Скорость (с тестами эквивалентности и счётчиками): журнал пачками, буфер логов, групповой коммит валюты и кеш закодированных транзакций, индекс плейсхолдеров, `Wildcards`, история событий, поиск перевода, HMAC, `PlayerHeads`. Файл валюты по-прежнему пишется целиком на каждое сохранение пачки.
- Копии баз: Postgres одной транзакцией, enum, параметры последовательностей, внешние ключи вне маски; MySQL литералы и размер INSERT; права на файлы. Identity-колонки и text/2dsphere-индексы Mongo неполно.
- Публикация: без ключа подписи работает `publishToMavenLocal`; подключение без публикации описано в `integration/README.md`.
- Порядок выпуска dev: `next` вливается в `main` PR (как #90), релиз запускается workflow `release` на `main`. Выпускается `0.1.0-dev.3`.

### 2026-11-08 (копии баз)
- Копии баз MySQL/MariaDB, MongoDB и PostgreSQL по аннотациям: `@BackupDatabase(tables = [...])` с масками `*`, `@BackupTable`, несколько баз на полях одного класса (`database = "ID"` у `@DatabaseField` и `@BackupTable`, без аннотаций на классе). Драйверы грузятся лениво через Libby при первом использовании.
- Меню копий идёт по плагинам и датам; выдача файлов копии вместо возврата (кнопка и `/pn updates backups files`).
- Обновление библиотеки сохраняет вариант `universal`; `universal-full` попадает в файлы релиза и `checksums.sha256`.
- Сверены `integration/` и CHANGELOG (раздел `next` сгруппирован), в инструкцию для плагинов добавлены резервные копии.
- Осталось: проверка на живых базах и серверах, релиз `0.1.0-dev.3`, идея отпечатка сервера, вес `universal` 5,6 МБ.

### 2026-11-05 (логгер, прокси, тесты)
- Логгер один: конфиги, интеграции Bukkit и перезапуск пишут через `PnLogger` (`PlatformPnLogger` в `runtime-spi`), серьёзное попадает в чёрный ящик; у `info`/`debug` можно передать исключение. Общая сборка связи прокси вынесена в `core/proxy/ProxyLink` с откатом при сбое запуска. Меню Bukkit перенесены в пакет `menu`.
- Логгер один: конфиги, интеграции Bukkit и перезапуск пишут через `PnLogger` (`PlatformPnLogger` в `spi`), серьёзное попадает в чёрный ящик; у `info`/`debug` можно передать исключение. Общая сборка связи прокси вынесена в `core/proxy/ProxyLink` с откатом при сбое запуска. Меню Bukkit перенесены в пакет `menu`.
- Перезапуск без `restart-script`: сервер останавливается, дальше его поднимает панель или start.sh, это не ошибка.
- FastStats оставлен как был (`ErrorTracker.contextAware()`), правку откатили по просьбе.
- Тесты: миграция конфигов, кадры связи и `LinkSecret`, откат обновления после сбоя публикации, задачи, скрытие секретов в отчёте. Ошибок не нашли.
Expand All @@ -79,7 +98,7 @@
- Изучены LimboAPI, LimboAuth, LimboFilter и LirTitles, правила записаны в «Как должен читаться код». Меню Bukkit разделено по ролям (`MenuSessions`, `BukkitMenuSession`, `MenuListener`, `MenuInventories`), флаги заменены методами. `PnLibraryImpl` переписан как сценарий запуска без псевдонимов (320 → 284). Убраны 124 однострочных KDoc над `override` вне публичного API. Проверено: `catch (Throwable)` почти везде прибирает и пробрасывает, это оставлено; `lateinit` в основном коде нет.
- Глобальный `LinkHub` заменён классом `Link`: его создаёт рантайм платформы (`openLink` на Bukkit, `connectLink` на Velocity/Bungee) и передаёт через конструкторы командам, меню (`MenuHost.link`) и слушателям. `/pnproxy` теперь регистрирует рантайм прокси, а не `PnLibraryLauncher`; команда запускается через `PnLibrary.dispatchRuntimeCommand`. Убраны `ProxyMenuCommands.runner` и `RemoteMenus.data`. На живой сети (прокси + сервер) не проверялось.
- Рефлексия: папку и логгер плагина теперь даёт платформа (`PlatformOwnerMetadata.ownerDataFolder/ownerLogger`), а не `getMethod("getDataFolder")` в ядре и конфигах. Folia собрана в `compat/Folia` (методы ищутся один раз, а не при каждой задаче и клике). Головы с текстурой — одна реализация (`PlayerHeads`), замена hex-цветов вынесена в `HexColors`. Убраны лишние: проверка Folia в bStats, `getOnlinePlayers` через рефлексию (нужно было только для 1.7). Оставшаяся рефлексия в Bukkit нужна: рантайм собран против Spigot 1.8 и зовёт новые API только там, где они есть.
- `DisplayZone.zone` оставлен: пишется один раз при старте из `config.yml`, это настройка отображения, протягивать `ZoneId` через 16 файлов форматирования незачем.
- `DisplayZone.zone` оставлен: пишется при старте и при смене `time-zone` из настроек библиотеки (`data/settings.json`), это настройка отображения, протягивать `ZoneId` через 16 файлов форматирования незачем.
- Дальше: комментарии-пересказы над `private`/`internal` (около 600, только вручную); на живом Folia-сервере новый `Folia` не проверялся.

### 2026-11-05 (документы)
Expand Down
Loading
Loading