Глоссарий
01Одно определение на термин, и это единственное место, где термин определён. Каждая другая страница ведёт сюда, когда впервые употребляет слово из этого списка; рядом с русским термином стоит английский, потому что команды, манифесты и спецификации говорят по-английски.
адаптация
02Версия документации на другом языке (adaptation): отдельный пакет, который зеркалит источник блок в блок и свободен предложение за предложением. В этом руководстве «перевод» и «адаптация» значат одно и то же. См. перевод.
03 The source language is English.org.vibevm.core/vibevm-docscarries[i18n].canonical = "en". Every other language, Russian included, is an adaptation published as its own package (§5): a mirror block for block, free sentence for sentence, with its own jokes and its own glossary of terms. Machine translation may produce a draft and never the text.
сессия агента
04Один запуск агента-кодера в проекте (agent session): от момента, когда он читает файл с инструкциями, до момента, когда останавливается. Стартовая полоса — это то, что vibe готовит к началу сессии.
якорь
05Идентификатор раздела или факта внутри спецификации (anchor), часть адреса после #. Опубликованный якорь никогда не меняется; переименование оставляет надгробие.
06 Anchors are immutable; a rename is a tombstone — for published documentation pages as for specs, and for translations, which must match their source.
номер блока
07Порядковый номер pNN, который каждый блок страницы документации получает при сборке (block number); он один и тот же в веб-странице, в Markdown и в XML, так что человек и агент ссылаются на одно место. Он называет текущий текст и может сдвинуться после правки, как номер строки.
08 Numbered blocks. Every flow block of the pivot — paragraph, list, table, fence, quote,example,rule,note,figure,prompt; a heading keeps its own id and is not numbered (clarified 2026-09-12 at implementation, followingPIPE-NUMBERING) — receives an ordinal number and the idpNNat build time in the Rust pipeline (§10), never by a client script. The number is the block's position in the current text of the page, counted beforewhenfiltering, so thatp12names the same block in the build for any platform and agent and in every translation; gaps in the rendered output are accepted. The number appears in the HTML island, in the.mdand.xmlprojections (as[p12]at the start of the block) and inllms-full.txt, so a human and an agent cite one place. After an edit an old#p12may point at a neighbouring block, as a link to a file line does after an edit; this is accepted and nothing tries to «remember» it. Headings keep their named anchors{#id}above the number; named anchors are immutable and renamed only by tombstone, positionalpNNlive by the current text.
стартовая полоса
09Упорядоченный список чтения, по которому агент идёт в начале сессии (boot lane): управляемый блок в файле с инструкциями, затем STATIC.md целиком, затем записи INDEX.md. Вычисляется vibe из графа зависимостей, руками не пишется никогда.
10 Session-start order: theCLAUDE.md/AGENTS.md/GEMINI.mdredirect →vibevm/vibespecs/boot/STATIC.xml(if present) →vibevm/vibespecs/boot/INDEX.mdand the entries it names, in order.
стартовый фрагмент
11Вклад пакета в стартовую полосу (boot snippet): один короткий текст, объявленный в [boot_snippet] с категорией, который каждый потребитель читает при каждом старте сессии. У пакетов документации его нет.
12[boot_snippet](package-role) drops thefilenamefield (theNN-target name) and gainscategory(§2.5);source— the path to the boot file inside the package — is retained. It may carry an optional suggestedlinkdefault, and an optionalwhenactivation condition — the declaration site for §2.3's dynamic-entrywhen, closing the gap Phase 4 flagged. For v1 the onlywhenis an operating-system match, the wire string"os:<name>"with<name>one ofwindows/macos/linux; a snippet carrying awhenisdynamic(§2.4). The package author owns this declaration: whether a boot snippet is OS-specific is the author's knowledge, not the consumer's.
возможность
13Абстрактное умение, которое пакет предоставляет или требует (capability), записывается как namespace:name с необязательным ограничением версии; при установке резолвер сводит требующих с предоставляющими.
14 Decision. A package's identity is the tuple(kind, name, version, content_hash). Thecontent_hashis a digest over the deterministically-ordered concatenation of(rel_path_bytes || 0x00 || file_bytes || 0x00)for every file in the package directory, and the value names the recipe that produced it (PROP-044 §4.7):sha256-tree/1:<hex>is recipe 1, whose exclusion list, path normalisation and traversal order are carried as data informats/hash_recipes/1.toml; the baresha256:<hex>is recipe 0, the pre-recipe form, frozen verbatim in code — not configurable, because a frozen recipe that can be edited is not frozen — so that values written before recipes were named stay readable. Two hashes are comparable only at the same recipe; comparing across recipes answers a question nobody asked, and is never done silently. PROP-024 §2.2 re-scopes this to the package's shippable tree — its source, minus build output (.git/,.vibe/,target/,node_modules/,.vibeignoreglobs) — so a code-bearing package's identity is its source, not its build state; that exclusion lands with the code that implements it. The URL used to fetch the content is informational — recorded in the lockfile for debuggability, not for identity.
документация сообщества
15Документация пакета, которая объявляет свой предмет, но предметом не названа (community documentation): на сайте показывается со своим издателем, ниже официальной полки. См. официальная документация.
16 Official documentation is the one whose edges converge: the subject named the package and the package declared the subject. Community documentation has only the edge from the documentation. An edge from the subject alone reads «not published or an error», and the site shows a warning.
компаньон
17Пакет, связанный с другим по имени ради умолчания об официальности и ничем больше (companion): документация <name>-docs пакета или перевод <docname>-<lang> документации. Компаньон держит собственную линию версий и не входит в унисон семейства.
18<family>-docs— the documentation companion (kind = "doc", PROP-057 §3): the official-by-default documentation of the family's subject, in the subject's group. Unlike the three code roles it is a companion, not a member: it is never pinned by the aggregator, it does not take part in the family's unison (§2.2), it keeps its own version line, and it states compatibility with its subject through the version constraint of its[[documents]]table. Its translations follow the same companion form, one package per language, named<family>-docs-<lang>with a lower-case BCP-47 tag (rust-ai-native-docs-ru). Amended 2026-09-11.
вклад
19Привязка обработчика к точке расширения (contribution), объявленная таблицей [[extension]] в пакете или проекте; единица, которую жизненный цикл выполняет и о которой отчитывается.
20
A contribution binds a handler to a point. It is declared as an [[extension]] table — in a package manifest (the package ships and offers the behaviour) or in the project manifest (the host adds its own). The shape is one grammar for every family:
координата
21Имя пакета (coordinate): группа, косая черта и имя, org.vibevm.world/wal, с @version, когда имеется в виду версия. Вид в неё не входит.
22 Decision. Package identity becomes(group, name, version, content_hash).kindleaves the identity tuple.
профиль выкладки
23Именованный упорядоченный список целей и провайдеров, которые применяют к ним упакованные артефакты (deploy profile); vibe deploy выполняет один профиль, vibe undeploy откатывает его.
24 Deploy profiles select ordered targets; plan is read-only. The engine owns provider selection, collision locks, intent/checkpoints, receipts, three-digest recovery, inverse sequencing and exact resource ownership.vibe-binplus isolated Claude/Codex/OpenCode skill/plugin adapters implement plan/apply/verify/recover/remove without touching foreign neighbours. Evidence:0a42456e,45d88e80,ae36ac48.
действующее множество
25Пакеты, которые метки видимости пропускают от вашего корня (effective set): то, что видит подбор версий, что записывает лок-файл и что держит дерево зависимостей. Приватное ребро пакета, который не ваш корень, лежит вне его.
26 Version resolution operates onE(R)only: private edges of non-root packages contribute no constraints, fetch nothing, and cannot conflict.vibe.lockrecordsE(R)— the lock of a consumer no longer contains other packages' dev-world entries. Version unification (one node per(group, name), PROP-003/017) is unchanged within the effective set. A welcome simplification vs code ecosystems: the Cargo-RFC-1977 problem («may private deps duplicate at different versions?») does not arise — an invisible package has no copies at all.
встроенный реестр
27Пакеты из дерева исходников собранного из них vibe, к которым он обращается автоматически как к реестру (embedded registry): первым — в сборке разработчика, после объявленных реестров — в распространяемой.
28 This PROP makes the in-treepackages/of a source-installedvibean ambient default registry — resolved automatically, with zero configuration in the consuming project.
точка расширения
29Именованное место в жизненном цикле, к которому привязывается вклад (extension point): фаза, слот внутри фазы или позиция в компиляторе полосы, записывается как family:name.
30 An extension point is a string<family>:<name>. Three families:phase:— the default-lifecycle phases andclean(project-scoped moments:phase:build,phase:create, …);compile:— the compiler's two tiers: the §7.2 staged positions (compile:source,compile:document,compile:lane,compile:emitted) and the §7.4 pass tier's single pointcompile:pass, whose position inside the pipeline is carried by the contribution'spass = { … }declaration;slot:— the per-package materialisation moments that already exist as PROP-020 (slot:pre-install,slot:post-install), re-stated in this vocabulary without changing their semantics, timing, or manifest spelling ([[hooks]](../modules/vibe-workspace/PROP-020-install-hooks.xml#manifest) keeps working verbatim; it is now sugar for twoslot:contributions).
факт
31Одна заякоренная единица спецификации со статусом (fact): правило, решение, вводная. В XML — элемент, названный по своему идентификатору, с fact="true"; в Markdown — абзац, начинающийся с @fact:ID. Адресуемый атом, на который ссылается агент.
32 Decision (ADR-part; owner ruling 2026-08-22, verbatim): «сконвертируй и факты тоже. Предлагаю такой формат<fact-name fact="true" ...>. Таким образом кастомный XML-парсер всегда может найти соответствующие элементы». A fact serialises with its ID as the element name, carrying the DISCRIMINATOR attribute —<THE-LAW fact="true" status="impl/done">body</THE-LAW>— so a reader that knows nothing of the vocabulary still finds every fact by one attribute test. The recognition law: an element IS a fact iff its name isfact(the generic form, which stays in the dialect) or it carriesfact="true". The named form is emitted whenever the id passes the same elementability predicate sections use (fact-id grammar already forbids leading digits, so the fallback tail is vocabulary collisions only); the typed-fact fence binding stays by id and does not change. The owner's second clause binds the scanners: the progress machinery must work when a fact's SOURCE — not a materialised copy — is authored XML; the host lane holds by construction (XML sources enter progress through the canonical MD projection) and is PINNED by explicit tests (an observed .xml source scans unit-for-unit equal to its MD twin), while the specmap engine's native reader learns the named form mirror-wise. The converter recipe bumps again (specdoc/2→specdoc/3); the host re-materialises once, after both shapes land. The owner's third clause (2026-08-22, same sitting) binds the boot lanes: «статические и динамические лоадеры должны хорошо работать с новым синтаксисом фактов» — pinned at the transition's landing by (a) the static-splice determinism test running over a NAMED-shape snippet whose projected facts survive into STATIC, (b) the vibe-spec normal-closure byte-equality test running over BOTH serialisations (generic and named) of one dependency, and (c) the polygon re-run at specdoc/3, whose control package auto-adopts the named shape through to_xml — INDEX targets, STATIC splice and every machine loader then exercise the final syntax end-to-end; the agent half of the dynamic router is §5a's measurement, deliberately run AFTER this transition so it measures the shape that ships. Landed: the recipe isspecdoc/3, the host's 37 slots re-materialised once with named facts live (the redbook README golden pins 45), the recognition law holds in both readers withfact="false"a loud error, progress holds full ParsedDoc parity between an XML source and its hand-pinned MD twin across two scans, and pins (a)–(c) are in the tree — the splice snippet ships<BOOT-RULE fact="true">, the normal closure compiles three lanes byte-equal, the polygon re-ran 3/3. A live lesson worth its line: XML reserves every case-insensitivexml-prefixed name, soXMLBOOTcannot be an element — the predicate refuses it and the generic form carries such ids.
семейство
33Набор пакетов с общей основой имени, которые движутся в унисон (family): бандл <family>, языковой гайд <family>-lang, сервер <family>-mcp. Изменение любого члена поднимает всех до одной версии.
34
A package family is a set of packages sharing a <family> stem and
delivering one coherent capability across three roles:
фича
35Необязательный добавочный набор содержимого пакета (feature), объявленный в [features] и включаемый при установке; фичи могут зависеть от фич.
36 Decision. A package'svibe-package.tomlgains a[features]table describing optional, conditionally-activated components:
отпечаток
37Хэш поставляемого дерева пакета (fingerprint), половина идентичности версии пакета; записывается как content_hash в лок-файл и проверяется при каждом скачивании.
38content_hashis unchanged — computed over package file bytes per PROP-002 §2.1.grouplives invibe.toml, so it influences the hash only as ordinary file content; the tuple lists it explicitly so that changinggroupyields a different package.
отпечаток свежести
39Хэш объявленных входов прогона фазы (freshness fingerprint), записанный под .vibe/; фаза, чей отпечаток свежести не изменился, при следующем прогоне пропускается.
40
Every phase execution owns a fingerprint — a hash over its declared inputs (for install: manifest+sources, already built; for build: the slot sources + project sources the preset names; for create: the prompt documents + their spec closure). A phase whose fingerprint matches the recorded one skips, reporting fresh per contribution — the Gradle up-to-date property grafted onto the Maven ritual. This is the design answer to «если vibe.toml не поменялся, инсталлировать пакеты не нужно», generalised to all nine phases because create (tokens) and build (native compile time) are even more expensive than install.
замыкание друзей
41Пакеты, с которыми проект подружился (friend closure): напрямую, через friend = true или строку friends, либо по цепочке рёбер «только для друзей». Зависимость «только для друзей» доходит лишь до проектов, чьё замыкание друзей содержит её поставщика.
42access = "friends-only"—Qseeps throughPonly into consumers whose friend closure containsP(§2.4): those who deliberately namedP(directly or transitively) a friend. The curated middle.
git-источник
43Зависимость, объявленная git-репозиторием и тегом, коммитом или веткой вместо реестра (git source); дисциплина идентичности и отпечатков та же, а ветка при обновлении обходится заново.
44 Identity. Identical content-hash discipline as registry-resolved (§2.1): identity is(kind, name, version, content_hash); the URL is informational. Two projects that pull the same git-source from different mirrors and produce the samecontent_hashare bit-identical installs. Force-pushed tag rewrite caught asIntegrityError.
обработчик
45То, что выполняет вклад (handler): встроенная функция, скрипт, бинарник, нативная библиотека или промпт агента.
46 A contribution'shandler.kindis one of five. Two wrap machinery that exists; three are new. All five are legal at everyphase:/slot:point; thecompile:family acceptsbuiltinandnativeonly (§8.5 explains why).
хук
47Скрипт пакета pre-install или post-install (hook), выполняемый в слоте пакета; установка пакета и есть согласие его запустить, а его последствия не отслеживаются.
48 A package may declarepre-install/post-installscripts in its manifest. vibevm runs them at fixed points in the install pipeline, in the package's own materialised slot, choosing the right interpreter for the host OS.
индекс (реестра)
49Репозиторий рядом с пакетами реестра, где записаны сводка и отпечаток каждой опубликованной версии (index); кэш, который ускоряет поиск и холодные установки и никогда не служит истиной.
50 Decision. Package repositories are the source of truth for content (manifests, files, tags). The index is a derived hot cache, regeneratable from the authoritative package state.
вид
51Для чего пакет нужен (kind), один из восьми: flow, feat, stack, tool, lang, mcp, doc, app. Метаданные, а не идентичность; набор растёт только поправкой.
52kind ∈ {flow, feat, stack, tool, mcp, lang, doc, app}— eight kinds;mcpshipped with PROP-027;docandappadmitted by PROP-057 through theVIBEVM-SPEC.md§4.1 amendment of 2026-09-12 (pending the owner's ratification at the merge of the docs-2026-09 branch; the code learns the two kinds in that campaign's phase 2). (§InvariantsINV-VOCABULARYin this file carries the same list.)
жизненный цикл
53Фиксированный порядок шагов сборки, которые выполняет vibe (lifecycle): однофазный цикл clean и девятифазный цикл default от validate до deploy. См. фаза.
54 vibe has two lifecycles.clean— one phase, exactly PROP-053.default— nine phases, in this fixed order:
тип связи
55Как стартовый фрагмент зависимости попадает в полосу потребителя (link type): static — вкомпилирован в STATIC.md, или dynamic — перечислен в INDEX.md и читается по требованию; задаёт потребитель, предлагает пакет.
56 Decision. Each dependency declares an inclusion type, set by the consumer in itsvibe.tomlon the[requires.packages]entry:
лок-файл
57vibe.lock: записанный результат подбора (lock file), один на рабочее пространство, с точной версией, отпечатком и происхождением каждого пакета. Пишет vibe, коммитите вы.
58 With the freshness check,vibe installbecomes lockfile-respecting: unchanged[requires]⇒ the locked versions are honoured verbatim.
управляемый блок
59Область между строками <vibevm> и </vibevm> в конце CLAUDE.md, AGENTS.md и GEMINI.md (managed block), единственная часть этих файлов, которую пишет vibe; она указывает агенту на стартовую полосу.
60
Decision. vibe owns exactly one managed block inside each agent instruction file — a contiguous region bounded by an opening and a closing marker.
манифест
61vibe.toml: единственный файл, который вы пишете, чтобы описать проект, пакет или рабочее пространство (manifest); его таблицы решают, какую роль играет узел.
62 Decision.vibe-package.tomlis retired as a distinct filename. Every node — project root, workspace member, published package — carries a singlevibe.toml; the role is expressed by which sections are present. This is the cargo model: oneCargo.tomlcarries[package]and/or[workspace].
MCP-сервер
63Программа, с которой агент общается по Model Context Protocol (MCP server). Собственный сервер vibe открывает пакеты проекта; пакет вида mcp поставляет свои серверы.
64
An mcp package is one whose primary deliverable is one or more
Model Context Protocol servers.
зеркало
65Запасной адрес того же реестра (mirror), к которому обращаются ради доступности и который проверяют по тем же отпечаткам; в лок-файл не записывается никогда.
66 A[[mirror]]is an availability copy of the same source — same naming, same identity, samecontent_hash. The mirror walk falls through on any availability failure (NetworkUnreachable,AuthFailedon the mirror, server error,content_hashmismatch).RepoNotFoundfrom a mirror bubbles up to the registry-walk layer (same policy as if the canonical primary had saidUnknownPackage), because absence-of-package is a registry-level fact, not a mirror-level one.
официальная документация
67Документация, у которой сходятся рёбра (official documentation): предмет называет пакет в [documentation] или по соглашению -docs, а пакет называет предмет в [[documents]]. Одна из них может быть первичной. Вычисляется при каждом рендере, флагом не хранится нигде.
68
Officiality is never stored as a flag: it is computed from the convergence of edges at every render. A field official = true in a manifest or an index is a design error.
переопределение
69Замещающий источник для одной координаты, который обходит реестры (override); в лок-файле помечен, чтобы никто не принял его за опубликованную версию. Тем же словом названа таблица [override], переписывающая метки видимости рёбер, которыми вы не владеете.
70
Decision. [[override]] bypasses the registry layer for a named pkgref:
71 Owner-ruled (2026-08-23):overrideis lawful in any manifest, not only the root («разрешён не только в корневом манифесте, а где угодно»). Any nodeNmay carry an[override]table whose entries rewrite foreign edges — theiraccess,friend, presence (exclude = true), or a target'sallow-friends— and the rewrite acts whereverNstands on the chain: an aggregator repairs or reshapes a member's edge for all of its own consumers, exactly as it curates its delivery withexclude. The threat model follows the owner's earlier ruling: a deliberate break-in is not an attack (the developer can edit any file on disk anyway); this is the official verb that replaces reflection-style hacks — and it stays quiet (pull-based provenance only).
пакет
72Единица, которую устанавливает vibe (package): папка с манифестом и тем текстом или инструментами, которые она приносит; публикуется как собственный репозиторий, опознаётся по координате, версии и хэшу содержимого. Пакет — это проект, который сделали устанавливаемым.
73 Decision. A package has the identical on-disk shape as a consumer project:
фаза
74Один шаг жизненного цикла (phase): validate, install, generate, build, test, create, verify, package, deploy. Назвать фазу — значит выполнить все фазы до неё.
75vibe <phase>executes every default-lifecycle phase up to and including the named one, in order — the Maven ritual verbatim.vibe clean <phase>runs the clean lifecycle first, then the default lifecycle up to<phase>(§4.4). A phase with no contributions and no built-in binding completes as a no-op — Maven's empty-phase law, which is what makes nine slots cost nothing for a prompt-only project (itsdeploychain degenerates to validate+install).
проект
76Любая папка с vibe.toml (project); потребитель пакетов, помеченный таблицей [project], или рабочее пространство таких потребителей.
77[package]and[project]are mutually exclusive in one file — a node is either a publishable package or a plain project, not both. (Decision 7-α from the design session: keep the two sections distinct rather than folding[project]into a[package]with optionalkind. Explicitness wins;kindstays strictly mandatory wherever[package]appears.)
провайдер
78То, что отвечает за исполнение механизма (provider): встроенная или поставленная пакетом реализация шага сборки, упаковки или выкладки либо модельная конечная точка за обработчиком-агентом. Выбирается точным маршрутом или пином.
79 A real installed package may displace a builtin deploy mechanism through an exact route/pin. The engine reuses ABI-1, R5 prebuilt/source record and immutable-image carriage, admits the generated mechanism manifest and exact operation, and invokes all six deploy operations while retaining plan/receipt/recovery ownership. Restart plan/recovery/undeploy re-resolve once at the command boundary and exact-compare the durable sidecar binding, existing record/image/digest/path without build, repair, publication or builtin fallback. Evidence:854707a1,9465291e,24b1fe4a,269bec0d,370ea177,a24e4aff,d475963c.
квитанция
80Запись, которую выкладка делает о каждом созданном ресурсе (receipt): что, где, под каким поколением, каким профилем владеется. Единственное основание для удаления.
81 Deploy profiles select ordered targets; plan is read-only. The engine owns provider selection, collision locks, intent/checkpoints, receipts, three-digest recovery, inverse sequencing and exact resource ownership.vibe-binplus isolated Claude/Codex/OpenCode skill/plugin adapters implement plan/apply/verify/recover/remove without touching foreign neighbours. Evidence:0a42456e,45d88e80,ae36ac48.
реестр
82Хостинг-организация, где публикуются пакеты, по репозиторию на пакет (registry); проект перечисляет реестры, которым доверяет, по порядку.
83 Each package is its own git repository — no monorepo. Per-package maintainer permissions are hosting-native (a package repo's owner controls access); no central merge queue.
эстафета
84Почтовый ящик под .vibe/agentic/, куда vibe кладёт инструкцию, которую не может выполнить сам (relay); агент разбирает его командой vibe command.
85 Decision. When a reasoning operation runs under the relay backend, it does not act. It writes anIntent— a markdown prompt with light frontmatter (id, source command, created-at, status) — to a single-slot mailbox, the project-local.vibe/agentic/command.md(§3), and returns a pointer telling the caller to drain it.
scrape
86Окончательное снятие слоя vibe с проекта, по контракту, с планом и доказательством здоровья; у слова нет устоявшегося русского эквивалента, команда так и называется — vibe scrape. Не путать с clean.
87 Scrape is the terminal cleaning operation defined here: it removes the selected VibeVM repository layer while preserving the native product. The command vocabulary deliberately reserves attach and detach for a future live-tool relationship such as connecting and disconnecting a debugger. Scrape is never an alias for that future runtime operation, and no detach spelling is accepted by this command.
навык
88Файл, который пакет объявляет в [[skill]] и который чему-то учит агента (skill); vibe skill install проецирует его в папки навыков агентов.
89 Decision. Installing a skill into an agent is a projection: read the declared skill body from the package (invibedeps/…once installed) or an external source authenticated by the package's matching lock record, and write it into each target agent's skill directory in that agent's own convention (.claude/skills/<name>/…,.opencode/skills/<name>/…,.agents/skills/<name>/…— the paths PROP-015 §2.6 already resolves).
спецификация
90Нормативный текст пакета или проекта под vibevm/vibespecs/ (specification): адресуемые единицы со статусами, в Markdown или в XML-диалекте. То, что документация цитирует и никогда не пересказывает.
91 spec://org.vibevm.world/addressable-specs/flows/addressable-specs/ADDRESSABLE-SPECS-PROTOCOL#THE-SPEC-TREE-IS-THE-ONLY-CHANNEL
хранилище
92Общий для машины кэш скачанных версий пакетов под ~/.vibe/cache/ (store), с ключом по идентичности, общий для всех проектов, очищается только по просьбе.
93 Decision (override clause corrected 2026-08-20 to the later, more specific ruling). The package store is machine-global, not project-scoped — one store per machine at<settings-home>/cache, relocated only with the settings home ($VIBE_SETTINGS); no store-specific override exists —##THE-STORE-IS-DOT-VIBE-CACHEis the governing ruling. (VIBE_REGISTRY_CACHE, which this decision originally named, governs the registry clone cache — a different layer that keeps its own job.)
предмет
94Пакет, который документирует пакет документации (subject); назван в его таблице [[documents]] с диапазоном версий.
95[[documents]]is REQUIRED in adocpackage, may list several subjects, and itsversionis a semver constraint.
поднавык
96Выбираемый срез содержимого пакета (subskill), включаемый контекстом потребителя, например версией библиотеки, которую использует проект.
97 Per §2.7 of PROP-004, Tessl's headline marketing claim — version-matched documentation — rides on thedescribesfield at the tile level. vibevm goes one step further: the field is available on subskills as well as packages. Aflow:walpackage as a whole may not bind to any one library, but itssubskills/stack/rust/cut binds specifically topkg:cargo/sqlx@0.8.0; anothersubskills/stack/rust-diesel/cut binds topkg:cargo/diesel@2.x. The two coexist in the same package, and the activation channelcontext.if_describes_matchselects the right one for the consumer's actual library version.
карта прослеживаемости
98specmap.json: сгенерированный граф единиц спецификации, помеченных элементов кода и рёбер между ними (traceability map); его проверяет сборка и запрашивают vibe explain, vibe query и vibe select.
99 Invariants are machine-checked. Dangling references, uncovered requirements, orphan code, and — the load-bearing one — staleness: a spec unit carries a revision + content hash; when it changes, every edge pinned to the old revision flips to suspect until re-affirmed.
перевод
100Отдельный пакет документации на другом языке (translation), который называет свой источник в [translates] и зеркалит его дерево; официален, когда опубликован группой источника под именем <docname>-<lang>. См. адаптация.
101 An official translation is one that declaredtranslateson the source and is published by the same group as the source under the name<docname>-<lang>; everything else is a community translation (§6).
ограничение версии
102То, что просит манифест (version constraint): диапазон вроде ^1.0, точная =1.2.0 или ничего — тогда новейшая стабильная. Лок-файл записывает ту одну версию, которую резолвер выбрал внутри него.
103
flow:wal@^0.3 → semver range.
рабочее пространство
104Репозиторий, разрабатывающий несколько пакетов вместе (workspace); объявляется таблицей [workspace] со списком путей участников; один лок-файл в корне и один общий подбор версий на всех участников.
105 Decision. Avibe.tomlmay carry a[workspace]table declaring member packages: