@dev-sergeev/datalab-kit 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.7 — 2026-10-20
+
+- Совместимость с Pi закреплена строго на `0.85.1`: peer-зависимости `pi-ai`, `pi-coding-agent` и `pi-tui` больше не допускают произвольные версии.
+- `@dev-sergeev/pi-gigachat` закреплён на `0.6.4` в манифесте, lockfile и отдельном источнике Pi. Установщик больше не запрашивает `latest`; штатное обновление Pi сохраняет закреплённую версию.
+- Прежняя незакреплённая запись GigaChat мигрирует на `npm:@dev-sergeev/pi-gigachat@0.6.4` с сохранением фильтров ресурсов. Явно выбранные пользователем версии и остальные настройки сохраняются.
+
 ## 0.1.6 — 2026-10-15
 
 - В пакет включены навыки `init` и `skill-creator`, доступные во всех проектах после глобальной установки набора. Добавлены короткие команды `/init` и `/skill-creator`; явное отключение ресурсов Pi сохраняет приоритет.

package/README.md

@@ -4,7 +4,7 @@
 
 ## Установка
 
-Нужны Node.js ≥ 22.19 и установленный Pi. Совместимость проверяется с Pi 0.85.1.
+Нужны Node.js ≥ 22.19 и установленный Pi **строго 0.85.1**. Peer-зависимости `@earendil-works/pi-ai`, `@earendil-works/pi-coding-agent` и `@earendil-works/pi-tui` закреплены на `0.85.1`, без диапазонов версий, как в `pi-gigachat` 0.6.4. Это декларация совместимости npm, а не runtime-проверка: управляемый установщик Pi использует `--legacy-peer-deps`.
 
 ```bash
 pi install npm:@dev-sergeev/datalab-kit
@@ -17,7 +17,7 @@ pi
 npm ci --ignore-scripts --legacy-peer-deps
 npm run build
 npm pack
-npm install --prefix /tmp/datalab-kit-local --legacy-peer-deps ./dev-sergeev-datalab-kit-0.1.6.tgz
+npm install --prefix /tmp/datalab-kit-local --legacy-peer-deps ./dev-sergeev-datalab-kit-0.1.7.tgz
 pi install /tmp/datalab-kit-local/node_modules/@dev-sergeev/datalab-kit
 ```
 
@@ -29,7 +29,7 @@ pi install /tmp/datalab-kit-local/node_modules/@dev-sergeev/datalab-kit
 
 | Пакет | Версия |
 | --- | --- |
-| `@dev-sergeev/pi-gigachat` | `latest` при установке / явном обновлении |
+| `@dev-sergeev/pi-gigachat` | 0.6.4 |
 | `@juicesharp/rpiv-ask-user-question` | 2.11.0 |
 | `pi-powerline-footer` | 0.17.2 |
 | `@gotgenes/pi-permission-system` | 33.0.5 |
@@ -42,9 +42,9 @@ pi install /tmp/datalab-kit-local/node_modules/@dev-sergeev/datalab-kit
 | `pi-toggle-skills` | 0.1.20 |
 | `@zigai/pi-mention-skill` | 0.10.4 |
 
-Одиннадцать фиксированных компонентов включены в архив npm вместе с их зависимостями. GigaChat устанавливается отдельно без закрепления версии.
+Одиннадцать фиксированных компонентов включены в архив npm вместе с их зависимостями. GigaChat устанавливается отдельно с закреплением версии `0.6.4`.
 
-Datalab Kit загружает штатное расширение GigaChat 0.6.1 без изменения его кода. `/gigachat` открывает интерактивный мастер подключений, авторизации и выбора моделей из каталогов серверов; это не интерфейс настройки через аргументы. Сохранённые подключения и пользовательские настройки остаются под управлением upstream. Основную модель выбирают через `/model`.
+Datalab Kit загружает штатное расширение GigaChat 0.6.4 без изменения его кода. `/gigachat` открывает интерактивный мастер подключений, авторизации и выбора моделей из каталогов серверов; это не интерфейс настройки через аргументы. Сохранённые подключения и пользовательские настройки остаются под управлением upstream.
 
 ## DataLab из окружения
 
@@ -123,13 +123,13 @@ YOLO автоматически разрешает `ask`. Явные `deny` и
 pi update --extensions
 ```
 
-GigaChat обновляется независимо от версии набора. Обычный запуск Pi не обращается к реестру npm и не устанавливает обновления.
+GigaChat закреплён на `0.6.4` в зависимостях набора и отдельном источнике Pi `npm:@dev-sergeev/pi-gigachat@0.6.4`. `pi update --extensions` не переводит его на более новую версию из `latest`; для смены версии нужен новый релиз набора либо явное пользовательское переопределение источника. Обычный запуск Pi не обращается к реестру npm и не устанавливает обновления.
 
-**Известное отклонение от спецификации:** Pi 0.85.1 перезаписывает список пакетов из своего кеша после `npm postinstall`. Поэтому отдельная запись GigaChat для штатного обновления восстанавливается при первом запуске Pi. Между установкой набора и первым запуском `pi update --extensions` не гарантирует обновление GigaChat при неизменной версии набора. Для полного выполнения этого требования нужна поддержка со стороны Pi; установленный Pi пакет не изменяет. Подробнее: [ADR](docs/adr/0002-package-delivery.md).
+**Особенность Pi 0.85.1:** установщик перезаписывает список пакетов из своего кеша после `npm postinstall`. Поэтому при первом запуске Pi набор восстанавливает отдельную закреплённую запись GigaChat. Прежний незакреплённый источник `npm:@dev-sergeev/pi-gigachat` заменяется на `npm:@dev-sergeev/pi-gigachat@0.6.4` с сохранением фильтров ресурсов. Подробнее: [ADR](docs/adr/0002-package-delivery.md).
 
 Явно закреплённый пользователем источник GigaChat сохраняется. При удалении набора отдельная запись GigaChat остаётся; её можно удалить стандартным `pi remove npm:@dev-sergeev/pi-gigachat`. Установка с `-l` пока не проверена.
 
-GigaChat загружается через штатную точку входа как внутри набора, так и через отдельную запись пакета. Для 0.6.1 настройка подключений и моделей выполняется интерактивным `/gigachat`; прежние утверждения о встроенных GLM/Qwen и автоматическом default `gigachat/Qwen3.5-397b` относились к 0.5.1 и к этой версии неприменимы. Datalab Kit не переписывает исходники GigaChat, не очищает авторизацию или сохранённые подключения. Дополнительный провайдер DataLab не меняет текущую модель или defaults. Модель recap настраивается независимо.
+GigaChat загружается через штатную точку входа как внутри набора, так и через отдельную запись пакета. Для 0.6.4 настройка подключений и моделей выполняется интерактивным `/gigachat`; прежние утверждения о встроенных GLM/Qwen и автоматическом default `gigachat/Qwen3.5-397b` относились к 0.5.1 и к этой версии неприменимы. Datalab Kit не переписывает исходники GigaChat, не очищает авторизацию или сохранённые подключения. Дополнительный провайдер DataLab не меняет текущую модель или defaults. Модель recap настраивается независимо.
 
 ## Разработка
 

package/THIRD_PARTY_NOTICES.md

@@ -2,7 +2,7 @@
 
 Datalab Kit includes the following upstream components. Their licenses and copyright notices remain in their package directories and apply to those components and their transitive dependencies. Datalab Kit modifies permission-system, plan-mode, subagents and recap's default model during build; see scripts/prepare-upstream.mjs. GigaChat is downloaded separately.
 
-- @dev-sergeev/pi-gigachat (latest, independently installed): MIT, git+https://github.com/dev-sergeev/pi-gigachat.git.
+- @dev-sergeev/pi-gigachat@0.6.4 (independently installed, version pinned): MIT, git+https://github.com/dev-sergeev/pi-gigachat.git.
 - @juicesharp/rpiv-ask-user-question@2.11.0: MIT, git+https://github.com/juicesharp/rpiv-mono.git.
 - pi-powerline-footer@0.17.2: MIT, git+https://github.com/nicobailon/pi-powerline-footer.git.
 - @gotgenes/pi-permission-system@33.0.5: MIT, git+https://github.com/gotgenes/pi-packages.git.

package/dist/extension.js

@@ -16,10 +16,10 @@ export default async function datalabKit(pi) {
         const provider = await import(pathToFileURL(gigaChatExtensionPath(packageRoot)).href);
         await provider.default(pi);
     }
-    if (!configured && managedAgentDir(packageRoot) === resolve(agentDir)) {
+    if (managedAgentDir(packageRoot) === resolve(agentDir)) {
         pi.on('session_start', async () => {
             // Pi 0.85.1 persists a cached package list after npm postinstall; repair
-            // that list at first activation without downloading or updating anything.
+            // that list and migrate the kit's former floating source without networking.
             await registerGigaChat(agentDir);
         });
     }

package/dist/install.d.ts

@@ -1,8 +1,8 @@
-export declare const gigaChatSource = "npm:@dev-sergeev/pi-gigachat";
+export declare const gigaChatSource: string;
 export declare function managedAgentDir(packageRoot: string): string | undefined;
 export declare function isGigaChatSource(entry: unknown): boolean;
 export declare function hasConfiguredGigaChat(agentDir: string): Promise<boolean>;
-/** Preserve every user field and package filter; only add a missing source. */
+/** Preserve user fields and filters; migrate the kit's former floating source. */
 export declare function registerGigaChat(agentDir: string): Promise<void>;
 /** Only run inside an explicit npm installation; Pi startup never calls this. */
 export declare function finishInstallation(packageRoot: string): Promise<void>;

package/dist/install.js

@@ -5,7 +5,9 @@ import { createRequire } from 'node:module';
 import { promisify } from 'node:util';
 import { execFile } from 'node:child_process';
 import { randomUUID } from 'node:crypto';
-export const gigaChatSource = 'npm:@dev-sergeev/pi-gigachat';
+const gigaChatPackageSource = 'npm:@dev-sergeev/pi-gigachat';
+const gigaChatVersion = createRequire(import.meta.url)('../package.json').dependencies['@dev-sergeev/pi-gigachat'];
+export const gigaChatSource = `${gigaChatPackageSource}@${gigaChatVersion}`;
 const execFileAsync = promisify(execFile);
 export function managedAgentDir(packageRoot) {
     const npmRoot = resolve(packageRoot, '../../..');
@@ -14,7 +16,7 @@ export function managedAgentDir(packageRoot) {
 }
 export function isGigaChatSource(entry) {
     const source = typeof entry === 'string' ? entry : entry && typeof entry === 'object' && 'source' in entry ? entry.source : undefined;
-    return typeof source === 'string' && (source === gigaChatSource || source.startsWith(`${gigaChatSource}@`));
+    return typeof source === 'string' && (source === gigaChatPackageSource || source.startsWith(`${gigaChatPackageSource}@`));
 }
 async function readSettings(agentDir) {
     let content;
@@ -35,7 +37,7 @@ export async function hasConfiguredGigaChat(agentDir) {
     const settings = await readSettings(agentDir);
     return Array.isArray(settings.packages) && settings.packages.some(isGigaChatSource);
 }
-/** Preserve every user field and package filter; only add a missing source. */
+/** Preserve user fields and filters; migrate the kit's former floating source. */
 export async function registerGigaChat(agentDir) {
     await mkdir(agentDir, { recursive: true });
     const lock = join(agentDir, 'settings.json.lock');
@@ -46,9 +48,13 @@ export async function registerGigaChat(agentDir) {
         if (settings.packages !== undefined && !Array.isArray(settings.packages))
             throw new Error('Pi packages must be an array');
         const packages = (settings.packages ?? []);
-        if (packages.some(isGigaChatSource))
+        const existing = packages.find(isGigaChatSource);
+        const source = typeof existing === 'string' ? existing : existing && typeof existing === 'object' && 'source' in existing ? existing.source : undefined;
+        if (existing && source !== gigaChatPackageSource)
             return;
-        settings.packages = [...packages, gigaChatSource];
+        settings.packages = existing
+            ? packages.map(entry => entry !== existing ? entry : typeof entry === 'string' ? gigaChatSource : { ...entry, source: gigaChatSource })
+            : [...packages, gigaChatSource];
         await writeFile(temp, `${JSON.stringify(settings, null, 2)}\n`, { mode: 0o600 });
         await rename(temp, join(agentDir, 'settings.json'));
     }
@@ -66,7 +72,7 @@ export async function finishInstallation(packageRoot) {
     const existing = Array.isArray(settings.packages) ? settings.packages.find(isGigaChatSource) : undefined;
     const source = typeof existing === 'string' ? existing : existing?.source;
     // An explicitly selected user version remains authoritative.
-    if (typeof source === 'string' && source !== gigaChatSource)
+    if (typeof source === 'string' && source !== gigaChatPackageSource && source !== gigaChatSource)
         return;
     await refreshGigaChat(agentDir);
     await registerGigaChat(agentDir);
@@ -89,14 +95,10 @@ async function npm(args) {
     return result.stdout;
 }
 async function refreshGigaChat(agentDir) {
-    const metadata = JSON.parse(await npm(['view', '@dev-sergeev/pi-gigachat@latest', 'version', '--json']));
-    const latest = Array.isArray(metadata) ? metadata.at(-1) : metadata;
-    if (typeof latest !== 'string' || !/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(latest))
-        throw new Error('Invalid GigaChat registry version');
     const destination = join(agentDir, 'npm/node_modules/@dev-sergeev/pi-gigachat');
     try {
         const installed = JSON.parse(await readFile(join(destination, 'package.json'), 'utf8'));
-        if (installed.version === latest)
+        if (installed.version === gigaChatVersion)
             return;
     }
     catch (error) {
@@ -109,7 +111,7 @@ async function refreshGigaChat(agentDir) {
     const replacement = join(stage, 'replacement');
     let moved = false;
     try {
-        await npm(['install', '--prefix', stage, `@dev-sergeev/pi-gigachat@${latest}`,
+        await npm(['install', '--prefix', stage, `@dev-sergeev/pi-gigachat@${gigaChatVersion}`,
             '--ignore-scripts', '--legacy-peer-deps', '--no-audit', '--no-fund']);
         await cp(join(stage, 'node_modules/@dev-sergeev/pi-gigachat'), replacement, { recursive: true });
         // Preserve the staged dependency tree so compiled ESM imports stay resolvable.

package/docs/adr/0002-package-delivery.md

@@ -1,6 +1,6 @@
 # ADR 0002: Доставка компонентов и значений по умолчанию
 
-Status: accepted for implementation; known spec gap remains
+Status: accepted
 
 ## Контекст
 
@@ -20,12 +20,12 @@ Pi 0.85.1 загружает ресурсы из `pi.extensions`, но не пр
 
 Дополнительное согласование от 2026-10-14: задержка автоматического recap после бездействия сокращена с 5 до 2 минут. Таймаут отдельного запроса остаётся 60 секунд.
 
-GigaChat остаётся зависимостью `latest`. При явной установке postinstall проверяет актуальную версию, устанавливает её в управляемый каталог Pi и добавляет незакреплённый источник. При первой активации расширение восстанавливает запись, которую установщик Pi мог затереть; загрузка не выполняет сетевых запросов. До появления отдельной записи провайдер подключается через расширение набора. После её появления его загружает Pi самостоятельно.
+Пересмотр от 2026-10-20: начиная с Datalab Kit 0.1.7 поддерживается строго Pi 0.85.1; три peer-зависимости Pi закреплены на этой версии без диапазонов, как в `pi-gigachat` 0.6.4. Это декларация совместимости, а не runtime-проверка: управляемый установщик Pi отключает разрешение peer-зависимостей. GigaChat закреплён на `0.6.4` в манифесте, lockfile, postinstall и отдельном источнике `npm:@dev-sergeev/pi-gigachat@0.6.4`. Версия для установщика берётся из манифеста набора; запрос `latest` удалён. Прежний незакреплённый источник мигрирует на закреплённый с сохранением фильтров ресурсов; явно выбранные пользователем версии остаются приоритетными. При первой активации расширение восстанавливает запись, которую установщик Pi мог затереть; загрузка не выполняет сетевых запросов. До появления отдельной записи провайдер подключается через расширение набора, после её появления его загружает Pi самостоятельно. Этот пересмотр заменяет прежнее требование независимо обновлять GigaChat до `latest`.
 
 ## Последствия и пределы
 
-- После первой активации работает штатное `pi update --extensions`, даже если версия набора не изменилась.
-- Обновление до первой активации не выполняет требование спецификации об независимо обновляемом GigaChat. Это открытый дефект совместимости с Pi; спецификация не ослабляется.
-- Полное решение требует изменения установщика Pi: сохранить добавленные lifecycle источники либо поддержать декларацию зависимых пакетов / hook обновления. Пакет не патчит установленный Pi и не запускает фоновый процесс изменения настроек.
+- Штатное `pi update --extensions` сохраняет GigaChat 0.6.4, даже если реестр публикует более новую версию.
+- Pi 0.85.1 по-прежнему может затереть добавленный в postinstall источник; он восстанавливается при первом запуске. Это больше не нарушает требование независимо обновлять GigaChat: такое требование отменено.
+- Пакет не патчит установленный Pi и не запускает фоновый процесс изменения настроек.
 - Исходные конфиги и явно закреплённые источники пользователя сохраняются.
 - Отдельный GigaChat остаётся после удаления набора. Очистка, `-l` и существующие независимые установки других компонентов не определены спецификацией.

package/node_modules/node-addon-api/common 2.gypi

@@ -0,0 +1,21 @@
+{
+  'variables': {
+    'NAPI_VERSION%': "<!(node -p \"process.env.NAPI_VERSION || process.versions.napi\")",
+    'disable_deprecated': "<!(node -p \"process.env['npm_config_disable_deprecated']\")"
+  },
+  'conditions': [
+    ['NAPI_VERSION!=""', { 'defines': ['NAPI_VERSION=<@(NAPI_VERSION)'] } ],
+    ['NAPI_VERSION==2147483647', { 'defines': ['NAPI_EXPERIMENTAL', 'NODE_API_EXPERIMENTAL_NO_WARNING'] } ],
+    ['disable_deprecated=="true"', {
+      'defines': ['NODE_ADDON_API_DISABLE_DEPRECATED']
+    }],
+    ['OS=="mac"', {
+      'cflags+': ['-fvisibility=hidden'],
+      'xcode_settings': {
+        'OTHER_CFLAGS': ['-fvisibility=hidden']
+      }
+    }]
+  ],
+  'cflags': [ '-Werror', '-Wall', '-Wextra', '-Wpedantic', '-Wunused-parameter' ],
+  'cflags_cc': [ '-Werror', '-Wall', '-Wextra', '-Wpedantic', '-Wunused-parameter' ]
+}

package/node_modules/node-addon-api/except 2.gypi

@@ -0,0 +1,25 @@
+{
+  'defines': [ 'NAPI_CPP_EXCEPTIONS' ],
+  'cflags!': [ '-fno-exceptions' ],
+  'cflags_cc!': [ '-fno-exceptions' ],
+  'conditions': [
+    ["OS=='win'", {
+      "defines": [
+        "_HAS_EXCEPTIONS=1"
+      ],
+      "msvs_settings": {
+        "VCCLCompilerTool": {
+          "ExceptionHandling": 1,
+          'EnablePREfast': 'true',
+        },
+      },
+    }],
+    ["OS=='mac'", {
+      'xcode_settings': {
+        'GCC_ENABLE_CPP_EXCEPTIONS': 'YES',
+        'CLANG_CXX_LIBRARY': 'libc++',
+        'MACOSX_DEPLOYMENT_TARGET': '10.7',
+      },
+    }],
+  ],
+}