feat(layers): рушій шарової документації + npm/docs як полігон - #57
Merged
Conversation
Новий workspace-пакет @7n/layers: подвійний CRC (essence + file) для
детермінованого виявлення застарілості шарів документації — зміна деталей
нижнього шару не тригерить перебудову верхнього, зміна суті тригерить.
LLM-генерація верхніх шарів і derived-переклади через @7n/llm-lib (каскад
локальні omlx-моделі → хмарні), CLI: status/refresh/build/bootstrap/translate.
npm/docs як перший полігон: 12 архітектурних глав отримали секцію "## Суть",
згенеровано 4 тематичні L2-огляди, 1 L1-огляд і L0-резюме в index.md
("подорож шарами"), усе перекладено на англійську.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
main пішов на 73 коміти вперед (Rust-рефакторинг crates/agent-core, .n-cursor.json → .n-rules.json, ADR-churn, dependency bumps). Конфлікти: package.json (скрипти), bun.lock (перегенеровано через bun install), 2 ADR-churn файли (взято main), npm/docs/vision.md (main суттєво розширив "## Теза" — інверсія делегування, mandates.md; суть позначено essence:draft і перегенеровано, каскад L2→L1→L0 перебудований і перекладений). Після merge 8 leaf-глав показали details-only (main змінив деталі поза "## Суть") — виправлено детермінованим refresh без LLM. Полігон npm/docs знову fresh: 6/6 шарів, 18/18 перекладів. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
@7n/layers— рушій шарової документації: подвійний CRC (essence-CRC для суті доки + file-CRC для повного тіла) детерміновано відрізняє «змінились приховані деталі» (details-only, верхній шар лишається свіжим) від «змінилось те, що видно шаром вище» (stale, потрібна перебудова). LLM-генерація верхніх шарів і derived-переклади — через@7n/llm-lib(каскад локальні omlx-моделі → хмарні). CLI:status/refresh/build/bootstrap/translate.npm/docsяк перший полігон: 12 архітектурних глав отримали секцію## Суть; згенеровано 4 тематичні L2-огляди (overview/{direction,core,runtime,people}.md) → 1 L1-огляд (overview/index.md) → L0-резюме уnpm/docs/index.md(«подорож шарами», зрозуміла нетехнічному читачу). Усе перекладено на англійську (18 файлів*.en.md).tags: [...]), повна матриця станівstatus, build/bootstrap/translate на injected-стабах.nitra/cursor/docs): деталь-only правка → лишеdetails-only, жодна верхня дока не перебудовується; правка суті → каскадstaleрівно на один шар вгору; LLM недоступна → чемний exit 3, файли не чіпаються.Test plan
npx vitest run --root layers— 95/95 зеленіbun run layers status npm/docs→fresh, exit 0architecture/graph.md→statusпоказує лишеdetails-onlyпоoverview/core.md, решта шарівfresh## Суть→ каскадstaleчерезoverview/core.md→overview/index.md→index.md,buildлікує каскадом доfreshnitra/cursor/docs(5 leaf-доків, чужийdocgen:-frontmatter) — повний цикл bootstrap→build→translate успішнийnpx --no @nitra/cursor lint— чисто, окрім одного зовнішнього блокера (див. нижче)Відомий блокер (поза цим PR)
text/run-v8rне знаходить JSON-схему для новихnpm/docs/layers.jsonіlayers/schemas/layers.schema.json— каталог схем живе у зовнішньому пакеті@nitra/cursor, встановлена версія (14.25.1) ще не має відповідного запису. Свідомо не додавав локальний ignore/exception — фікс належить upstream-пакету.🤖 Generated with Claude Code