Pociąg wydań 0.3

Wspólne pakiety Skribly wychodzą teraz jako pociąg wydań: jeden pociąg na wersję minor, więc pakiety z tego samego pociągu na pewno ze sobą działają. Pociąg 0.3 jest pierwszy. Poprawka w ramach pociągu podnosi tylko pakiet, który poprawia, jako 0.3.1, 0.3.2 i tak dalej.

Pakiet	Wersja	Wcześniej
@skribly/core	0.3.0	0.2.0
agent-skills	0.3.0	0.2.14
@skribly/ui	dołącza w późniejszym pociągu (zostaje 0.1.0)	0.1.0

@skribly/ui nie jedzie tym pociągiem: jego następna wersja czeka na prace nad kierunkiem projektu i komponentami panelu administracyjnego i dołączy do późniejszego pociągu. Do tego czasu z core 0.3.0 idzie ui 0.1.0, a strony zachowują swoją kopię zestawu dla stron.

Które wersje należą do którego pociągu, zapisuje compat.json w repozytorium core: wersje pociągu, pakiety, które dołączą później, commit ui, którego używa każda strona, najstarsze Skribly Agent i Skribly Tracker działające z pociągiem oraz wersje Node.js, Astro, React i Next.js, na których go przetestowano.

• Zestaw serwerowy: osiem punktów wejścia pod @skribly/core/server/ z kodem, którego każdy serwer Skribly potrzebuje od pierwszego dnia. db otwiera Postgres (w testach PGlite) i wykonuje każde żądanie w transakcji jego organizacji pod zabezpieczeniem na poziomie wierszy. events zapisuje zdarzenia w skrzynce nadawczej w tej samej transakcji i uruchamia zadania w tle. seed wypełnia bazę danymi minimalnymi lub demonstracyjnymi. app łączy moduły aplikacji. http dodaje wspólne middleware Hono: błędy jako problem details, limit rozmiaru treści, klucze idempotencji, które nigdy nie wykonują zapisu dwa razy, i limity żądań. mcp udostępnia akcje aplikacji jako narzędzia MCP pod /mcp, a zapisy potwierdza człowiek. testing daje testy izolacji i testy między organizacjami. telemetry wysyła ślady OpenTelemetry.
• Kontrakty: konwencje API (wersja w ścieżce, stronicowanie kursorem), porty z atrapami do testów, Standard Schema, Standard Webhooks, katalog zdarzeń każdego produktu, tożsamość z przestrzeniami roboczymi i instalacjami, API administracyjne Skribly ID (eksperymentalne), manifest v2, rejestr i katalog produktów, flagi funkcji (eksperymentalne) oraz więcej operacji Skribly Tracker w kontraktach i kliencie.
• Pliki generowane: plik JSON Schema dla każdego schematu i pliki OpenAPI 3.1 dla Skribly Tracker i Skribly ID.
• Presety: wspólna konfiguracja Prettier jako @skribly/core/prettier i preset oxlint dla aplikacji Next.js.

• Cztery nowe umiejętności: newsletter, slice, seed i standard. Zobacz Katalog umiejętności.

• Core: żądanie może otworzyć tylko transakcję organizacji, do której jest zalogowane (401 bez logowania, 403 dla innej organizacji). Każde sprawdzenie dostępu wskazuje organizację. Daty, adresy webhooków i linki są sprawdzane dokładniej.
• agent-skills: wydania idą teraz z pociągiem. Wydanie powstaje tylko dla tagu wersji, na przykład v0.3.0; wydania numerowane kolejnymi budowaniami (v0.2.1 do v0.2.14) kończą się tutaj.
• agent-skills: agent-skills agent-files domyślnie zapisuje tylko CLAUDE.md i wskaźnik dla Copilota, a --prune usuwa to, co zapisały starsze wersje. Skrypty umiejętności nigdy nie uruchamiają programu znalezionego w repozytorium, w którym pracujesz. Zobacz Obsługiwani agenci.

• Core: nagłówki limitu żądań ustawione przez handler zostają zachowane, a każde ustalenie listopadowego przeglądu zestawu serwerowego jest zamknięte.
• agent-skills: agent-files nie wychodzi poza repozytorium, w którym działa, i nie zastępuje już Twojego .mcp.json.

1. @skribly/core 0.3.0 nie jest jeszcze w GitHub Packages: publikację wykonuje workflow wydania, który przyjdzie później. Do tego czasu aplikacje instalują core z paczki w swoim folderze vendor/; spakuj ją na nowo z tagu v0.3.0 poleceniem node .tools/pack-libs.mjs <aplikacja> w core. @skribly/ui zostaje przy paczce 0.1.0.
2. Gdy core zostanie opublikowany, aplikacja kopiuje szablon .npmrc z repozytorium core (.tools/npmrc.template), ustawia token z prawem odczytu pakietów jako NODE_AUTH_TOKEN, przypina dokładnie "@skribly/core": "0.3.0" i używa wspólnej konfiguracji Prettier przez "prettier": "@skribly/core/prettier" w package.json zamiast własnego .prettierrc.json.
3. Przed migracją bazy uruchom ponownie konfigurację bazy z zestawu serwerowego: dodaje rolę, której potrzebują nowe migracje.
4. Kod, który otwierał transakcję dla pracy poza organizacją, na przykład logowania, przechodzi na db.identity. Sprawdzenia dostępu przekazują organizację.
5. Uruchom ponownie agent-skills install, a potem raz agent-skills agent-files --prune w każdym repozytorium.