@kb-labs/devkit 1.4.0 → 2.9.0

package/.github/workflows/ci-reusable.yml

@@ -1,131 +0,0 @@
-name: reusable-ci
-
-on:
-  workflow_call:
-    inputs:
-      node-version:
-        description: Node.js version
-        required: false
-        default: '20'
-        type: string
-      run-coverage:
-        description: Run coverage step
-        required: false
-        default: true
-        type: boolean
-      enable-drift-check:
-        description: Run DevKit drift check (fails on drift)
-        required: false
-        default: true
-        type: boolean
-
-jobs:
-  drift:
-    if: ${{ inputs.enable-drift-check == true }}
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    concurrency:
-      group: ${{ github.workflow }}-${{ github.ref }}-drift
-      cancel-in-progress: true
-    steps:
-      - uses: actions/checkout@v4
-      - uses: KirillBaranov/kb-labs-devkit/.github/actions/setup-node-pnpm@main
-        with:
-          node-version: ${{ inputs['node-version'] }}
-      - name: Install deps
-        run: pnpm i --frozen-lockfile
-      - name: DevKit drift check
-        # Repos are expected to ship a script `devkit:check` that runs the sync tool in check mode
-        run: pnpm -s devkit:check
-
-  validate:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    concurrency:
-      group: ${{ github.workflow }}-${{ github.ref }}-validate
-      cancel-in-progress: true
-    steps:
-      - uses: actions/checkout@v4
-      - uses: KirillBaranov/kb-labs-devkit/.github/actions/setup-node-pnpm@main
-        with:
-          node-version: ${{ inputs['node-version'] }}
-      - name: Install deps
-        run: pnpm i --frozen-lockfile
-      - name: Lint
-        run: pnpm lint
-      - name: Type check
-        run: pnpm type-check || true
-
-  build:
-    runs-on: ubuntu-latest
-    needs: validate
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v4
-      - uses: KirillBaranov/kb-labs-devkit/.github/actions/setup-node-pnpm@main
-        with:
-          node-version: ${{ inputs['node-version'] }}
-      - name: Install deps
-        run: pnpm i --frozen-lockfile
-      - name: Build (workspace)
-        run: pnpm -r run build || true
-      - name: Upload build outputs
-        uses: actions/upload-artifact@v4
-        with:
-          name: build-dist
-          path: |
-            packages/**/dist/
-            dist/
-          if-no-files-found: ignore
-
-  test:
-    runs-on: ubuntu-latest
-    needs: build
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v4
-      - uses: KirillBaranov/kb-labs-devkit/.github/actions/setup-node-pnpm@main
-        with:
-          node-version: ${{ inputs['node-version'] }}
-      - name: Install deps
-        run: pnpm i --frozen-lockfile
-      - name: Download build outputs
-        uses: actions/download-artifact@v4
-        with:
-          name: build-dist
-          path: .
-      - name: Test (no watch)
-        run: pnpm test -- --run
-
-  coverage:
-    if: ${{ inputs['run-coverage'] == true }}
-    runs-on: ubuntu-latest
-    needs: build
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v4
-      - uses: KirillBaranov/kb-labs-devkit/.github/actions/setup-node-pnpm@main
-        with:
-          node-version: ${{ inputs['node-version'] }}
-      - name: Install deps
-        run: pnpm i --frozen-lockfile
-      - name: Download build outputs
-        uses: actions/download-artifact@v4
-        with:
-          name: build-dist
-          path: .
-      - name: Coverage
-        run: pnpm test:coverage
-      - name: Upload coverage (if any)
-        uses: actions/upload-artifact@v4
-        with:
-          name: coverage-html
-          path: |
-            coverage/
-            **/coverage/
-          if-no-files-found: ignore

package/.github/workflows/deploy-reusable.yml

@@ -1,110 +0,0 @@
-name: reusable-deploy
-
-# Reusable workflow: deploy to VPS via SSH + docker compose
-#
-# Usage in orchestrator repo (e.g. kb-labs root):
-#   jobs:
-#     call:
-#       uses: KirillBaranov/kb-labs-devkit/.github/workflows/deploy-reusable.yml@main
-#       with:
-#         image-tag: release-1.0.0
-#         compose-file: docker-compose.production.yml
-#       secrets: inherit
-#
-# Required secrets in calling repo:
-#   VPS_HOST, VPS_USER, VPS_SSH_KEY
-
-on:
-  workflow_call:
-    inputs:
-      image-tag:
-        description: Docker image tag to deploy (e.g. release-1.0.0)
-        required: true
-        type: string
-      compose-file:
-        description: Path to docker-compose file on VPS
-        required: false
-        default: docker-compose.production.yml
-        type: string
-      deploy-dir:
-        description: Working directory on VPS
-        required: false
-        default: /opt/kb-labs
-        type: string
-      registry:
-        description: Container registry host
-        required: false
-        default: ghcr.io
-        type: string
-      health-check-url:
-        description: URL to check after deploy (e.g. http://localhost:5050/api/v1/health)
-        required: false
-        default: ''
-        type: string
-      health-check-wait:
-        description: Seconds to wait before health check
-        required: false
-        default: '15'
-        type: string
-    secrets:
-      VPS_HOST:
-        required: true
-      VPS_USER:
-        required: true
-      VPS_SSH_KEY:
-        required: true
-
-jobs:
-  deploy:
-    name: Deploy to VPS
-    runs-on: ubuntu-latest
-    environment: production
-
-    steps:
-      - name: Deploy via SSH
-        uses: appleboy/ssh-action@v1
-        env:
-          DEPLOY_TAG: ${{ inputs.image-tag }}
-          DEPLOY_REGISTRY: ${{ inputs.registry }}/${{ github.repository_owner }}
-        with:
-          host: ${{ secrets.VPS_HOST }}
-          username: ${{ secrets.VPS_USER }}
-          key: ${{ secrets.VPS_SSH_KEY }}
-          envs: DEPLOY_TAG,DEPLOY_REGISTRY
-          script: |
-            set -euo pipefail
-            cd ${{ inputs.deploy-dir }}
-
-            echo "→ Deploying tag: $DEPLOY_TAG"
-            echo "→ Registry: $DEPLOY_REGISTRY"
-
-            # Save current tag for rollback
-            [ -f .current-tag ] && cp .current-tag .previous-tag
-            echo "$DEPLOY_TAG" > .current-tag
-
-            # Pull new images
-            TAG="$DEPLOY_TAG" REGISTRY="$DEPLOY_REGISTRY" \
-              docker compose -f ${{ inputs.compose-file }} pull
-
-            # Rolling update
-            TAG="$DEPLOY_TAG" REGISTRY="$DEPLOY_REGISTRY" \
-              docker compose -f ${{ inputs.compose-file }} up -d --remove-orphans
-
-            echo "→ Containers started, waiting ${{ inputs.health-check-wait }}s..."
-            sleep ${{ inputs.health-check-wait }}
-
-            # Show status
-            docker compose -f ${{ inputs.compose-file }} ps
-
-            # Health check (if URL provided)
-            if [ -n "${{ inputs.health-check-url }}" ]; then
-              echo "→ Health check: ${{ inputs.health-check-url }}"
-              wget -qO- "${{ inputs.health-check-url }}" \
-                && echo "✓ Health check passed" \
-                || { echo "✗ Health check failed!"; exit 1; }
-            fi
-
-            # Cleanup old images
-            docker image prune -f > /dev/null 2>&1 || true
-
-            echo "✓ Deploy complete: $DEPLOY_TAG"

package/.github/workflows/docker-build-reusable.yml

@@ -1,110 +0,0 @@
-name: reusable-docker-build
-
-# Reusable workflow: build Docker image and push to ghcr.io
-#
-# Usage in consumer repo:
-#   jobs:
-#     call:
-#       uses: KirillBaranov/kb-labs-devkit/.github/workflows/docker-build-reusable.yml@main
-#       with:
-#         image-name: kb-labs-rest-api
-#         dockerfile: Dockerfile
-#       secrets: inherit
-
-on:
-  workflow_call:
-    inputs:
-      image-name:
-        description: Docker image name (e.g. kb-labs-rest-api)
-        required: true
-        type: string
-      dockerfile:
-        description: Path to Dockerfile (relative to context)
-        required: false
-        default: Dockerfile
-        type: string
-      context:
-        description: Docker build context (default is repo root)
-        required: false
-        default: .
-        type: string
-      build-args:
-        description: Build args as multiline string (KEY=VALUE per line)
-        required: false
-        default: ''
-        type: string
-      platforms:
-        description: Target platforms (e.g. linux/amd64,linux/arm64)
-        required: false
-        default: linux/amd64
-        type: string
-      registry:
-        description: Container registry host
-        required: false
-        default: ghcr.io
-        type: string
-    outputs:
-      image-tag:
-        description: Full image tag that was pushed
-        value: ${{ jobs.build.outputs.image-tag }}
-      short-sha:
-        description: Short commit SHA used as tag
-        value: ${{ jobs.build.outputs.short-sha }}
-
-jobs:
-  build:
-    name: Build & Push
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: write
-
-    outputs:
-      image-tag: ${{ steps.meta.outputs.version }}
-      short-sha: ${{ steps.sha.outputs.short }}
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          submodules: recursive
-
-      - name: Get short SHA
-        id: sha
-        run: echo "short=${GITHUB_SHA::7}" >> $GITHUB_OUTPUT
-
-      - name: Log in to Container Registry
-        uses: docker/login-action@v3
-        with:
-          registry: ${{ inputs.registry }}
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: Docker metadata
-        id: meta
-        uses: docker/metadata-action@v5
-        with:
-          images: ${{ inputs.registry }}/${{ github.repository_owner }}/${{ inputs.image-name }}
-          tags: |
-            # rc branch → rc-<sha>
-            type=raw,value=rc-${{ steps.sha.outputs.short }},enable=${{ github.ref == 'refs/heads/rc' }}
-            # release tag → release-1.0.0
-            type=raw,value=${{ github.ref_name }},enable=${{ startsWith(github.ref, 'refs/tags/release-') }}
-            # always tag latest on release
-            type=raw,value=latest,enable=${{ startsWith(github.ref, 'refs/tags/release-') }}
-
-      - name: Build and push
-        uses: docker/build-push-action@v6
-        with:
-          context: ${{ inputs.context }}
-          file: ${{ inputs.dockerfile }}
-          platforms: ${{ inputs.platforms }}
-          push: true
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
-          build-args: ${{ inputs.build-args }}
-          cache-from: type=gha,scope=${{ inputs.image-name }}
-          cache-to: type=gha,mode=max,scope=${{ inputs.image-name }}

package/.github/workflows/drift-check-reusable.yml

@@ -1,23 +0,0 @@
-name: reusable-drift-check
-
-on:
-  workflow_call:
-    inputs:
-      node-version:
-        default: '20'
-        type: string
-
-jobs:
-  drift:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: KirillBaranov/kb-labs-devkit/.github/actions/setup-node-pnpm@main
-        with:
-          node-version: ${{ inputs.node-version }}
-      - run: pnpm i --frozen-lockfile
-      - name: DevKit drift check
-        run: |
-          pnpm -s devkit:check || \
-          node scripts/devkit-sync.mjs --check || \
-          ./node_modules/.bin/kb-devkit-sync --check

package/.github/workflows/fixtures.yml

@@ -1,74 +0,0 @@
-name: DevKit Fixtures
-
-on:
-  push:
-    branches: [ main ]
-    paths-ignore:
-      - '**/*.md'
-      - '**/.vscode/**'
-      - '**/.idea/**'
-  pull_request:
-    types: [opened, synchronize, reopened]
-  workflow_dispatch: {}
-  schedule:
-    - cron: '0 3 * * 1' # weekly canary (Mon 03:00 UTC)
-
-permissions:
-  contents: read
-
-concurrency:
-  group: devkit-fixtures-${{ github.event.pull_request.number || github.sha }}
-  cancel-in-progress: true
-
-jobs:
-  fixtures:
-    name: Run fixtures (all)
-    runs-on: ubuntu-latest
-    env:
-      CI: true
-
-    steps:
-      - uses: actions/checkout@v4
-        with: { fetch-depth: 0 }
-
-      - uses: KirillBaranov/kb-labs-devkit/.github/actions/setup-node-pnpm@main
-        with:
-          node-version: '20'
-
-      - name: Cache pnpm store
-        uses: actions/cache@v4
-        with:
-          path: ~/.pnpm-store
-          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
-          restore-keys: |
-            ${{ runner.os }}-pnpm-store-
-
-      - name: Install DevKit deps
-        run: pnpm i --frozen-lockfile
-
-      - name: Clean fixtures
-        run: pnpm fixtures:clean || true
-
-      - name: Bootstrap fixtures
-        run: pnpm fixtures:bootstrap
-
-      - name: Run fixtures (smart check)
-        shell: bash
-        run: |
-          if [ "${{ github.event_name }}" = "pull_request" ] && [ -n "${{ github.base_ref }}" ]; then
-            echo "Running differential fixtures check since origin/${{ github.base_ref }}"
-            pnpm fixtures -- --action=check --since=origin/${{ github.base_ref }}
-          else
-            echo "Running full fixtures check"
-            pnpm fixtures:check
-          fi
-
-      - name: Upload artifacts (optional)
-        if: always()
-        uses: actions/upload-artifact@v4
-        with:
-          name: fixtures-artifacts
-          path: |
-            fixtures/**/coverage/**
-            fixtures/**/dist/**
-          if-no-files-found: ignore

package/.github/workflows/profiles-validate-reusable.yml

@@ -1,67 +0,0 @@
-name: profiles-validate
-
-on:
-  workflow_call:
-    inputs:
-      node_version:
-        type: string
-        default: '20'
-      soft_fail:
-        type: boolean
-        default: true      # don't fail, while profiles are in development
-      working_directory:
-        type: string
-        default: '.'       # for monorepo — can specify the package path
-      log_level:
-        type: string
-        default: 'info'    # debug|info|warn|error
-      fixtures_dir:
-        type: string
-        default: ''        # optional, if there are presets/fixtures
-
-jobs:
-  validate:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Detect .kb/profiles
-        id: detect
-        shell: bash
-        run: |
-          ROOT="${{ inputs.working_directory }}"
-          if [ -d "$ROOT/.kb/profiles" ]; then
-            echo "found=true" >> "$GITHUB_OUTPUT"
-            echo "[profiles] found at $ROOT/.kb/profiles"
-          else
-            echo "found=false" >> "$GITHUB_OUTPUT"
-            echo "[profiles] not found, skip"
-          fi
-
-      - name: Setup Node & pnpm
-        if: steps.detect.outputs.found == 'true'
-        uses: KirillBaranov/kb-labs-devkit/.github/actions/setup-node-pnpm@main
-        with:
-          node-version: ${{ inputs.node_version }}
-
-      - name: Install deps
-        if: steps.detect.outputs.found == 'true'
-        run: pnpm i --frozen-lockfile
-        working-directory: ${{ inputs.working_directory }}
-
-      - name: Validate profiles
-        if: steps.detect.outputs.found == 'true'
-        continue-on-error: ${{ inputs.soft_fail }}
-        env:
-          LOG_LEVEL: ${{ inputs.log_level }}
-          KB_PROFILES_FIXTURES: ${{ inputs.fixtures_dir }}
-        shell: bash
-        run: |
-          # if kb-CLI is available, use it, otherwise use the package schemas
-          if pnpm -s kb --help >/dev/null 2>&1; then
-            pnpm -s kb profiles validate
-          else
-            pnpm -F @kb-labs/profile-schemas -s run schemas:check
-          fi
-        working-directory: ${{ inputs.working_directory }}

package/.github/workflows/release-reusable.yml

@@ -1,50 +0,0 @@
-name: reusable-release
-
-on:
-  workflow_call:
-    inputs:
-      publish:
-        description: Publish to npm
-        required: false
-        default: false
-        type: boolean
-      node-version:
-        default: '20'
-        type: string
-    secrets:
-      NPM_TOKEN:
-        required: false
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-    steps:
-      - uses: actions/checkout@v4
-
-      # Composite action: pnpm + Node + cache
-      - uses: KirillBaranov/kb-labs-devkit/.github/actions/setup-node-pnpm@main
-        with:
-          node-version: ${{ inputs['node-version'] }}
-
-      # Add registry for npm publish (separate step — так надёжнее)
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ inputs['node-version'] }}
-          cache: pnpm
-          registry-url: 'https://registry.npmjs.org'
-
-      - run: pnpm i --frozen-lockfile
-      - run: pnpm build || true
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          generate_release_notes: true
-
-      - name: Publish to npm
-        if: ${{ inputs.publish == true }}
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: pnpm -r publish --access public --no-git-checks

package/.vscode/settings.json

@@ -1,23 +0,0 @@
-{
-  "editor.tabSize": 2,
-  "editor.insertSpaces": true,
-  "editor.formatOnSave": true,
-  "files.eol": "\n",
-  // ESLint (flat config)
-  "eslint.useFlatConfig": true,
-  "eslint.experimental.useFlatConfig": true,
-  "eslint.validate": [
-    "javascript",
-    "javascriptreact",
-    "typescript",
-    "typescriptreact",
-    "vue"
-  ],
-  // Prettier
-  "prettier.requireConfig": true,
-  // TypeScript: использовать локальную версию в репозитории
-  "typescript.tsdk": "node_modules/typescript/lib",
-  // Vitest
-  "vitest.enable": true,
-  "vitest.disableWorkspaceWarning": true
-}

package/tsconfig/dist/__tests__/cache.spec.d.ts

@@ -1,6 +0,0 @@
-/**
- * @module @kb-labs/core/config/__tests__/cache.spec.ts
- * Tests for filesystem cache functionality
- */
-export {};
-//# sourceMappingURL=cache.spec.d.ts.map

package/tsconfig/dist/__tests__/cache.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.spec.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/__tests__/cache.spec.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/tsconfig/dist/__tests__/cache.spec.js

@@ -1,85 +0,0 @@
-/**
- * @module @kb-labs/core/config/__tests__/cache.spec.ts
- * Tests for filesystem cache functionality
- */
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import { promises as fsp } from 'node:fs';
-import path from 'node:path';
-import { tmpdir } from 'node:os';
-import { fsCache, clearCaches } from '../cache/fs-cache';
-import { readConfigFile } from '../api/read-config';
-describe('Filesystem Cache', () => {
-    let testDir;
-    beforeEach(async () => {
-        testDir = path.join(tmpdir(), `kb-labs-cache-test-${Date.now()}`);
-        await fsp.mkdir(testDir, { recursive: true });
-        clearCaches();
-    });
-    afterEach(async () => {
-        await fsp.rm(testDir, { recursive: true, force: true });
-        clearCaches();
-    });
-    describe('Cache Operations', () => {
-        it('should cache file reads', async () => {
-            const configPath = path.join(testDir, 'test-config.json');
-            const configData = { test: 'value' };
-            await fsp.writeFile(configPath, JSON.stringify(configData, null, 2));
-            // First read - should not be cached
-            const result1 = await readConfigFile(configPath);
-            expect(result1.data).toEqual(configData);
-            // Second read - should be cached
-            const result2 = await readConfigFile(configPath);
-            expect(result2.data).toEqual(configData);
-        });
-        it('should invalidate cache on file change', async () => {
-            const configPath = path.join(testDir, 'test-config.json');
-            const configData1 = { test: 'value1' };
-            const configData2 = { test: 'value2' };
-            await fsp.writeFile(configPath, JSON.stringify(configData1, null, 2));
-            // First read
-            const result1 = await readConfigFile(configPath);
-            expect(result1.data).toEqual(configData1);
-            // Small delay to ensure mtime changes
-            await new Promise(resolve => setTimeout(resolve, 10));
-            // Modify file
-            await fsp.writeFile(configPath, JSON.stringify(configData2, null, 2));
-            // Second read - should get new data
-            const result2 = await readConfigFile(configPath);
-            expect(result2.data).toEqual(configData2);
-        });
-        it('should clear caches', async () => {
-            const configPath = path.join(testDir, 'test-config.json');
-            const configData = { test: 'value' };
-            await fsp.writeFile(configPath, JSON.stringify(configData, null, 2));
-            // Read to populate cache
-            await readConfigFile(configPath);
-            // Clear cache
-            clearCaches();
-            // Verify cache is cleared by checking stats
-            const stats = fsCache.getStats();
-            expect(stats.size).toBe(0);
-        });
-        it('should handle YAML files', async () => {
-            const configPath = path.join(testDir, 'test-config.yaml');
-            const configData = { test: 'value', nested: { key: 'value' } };
-            await fsp.writeFile(configPath, `test: value\nnested:\n  key: value`);
-            const result = await readConfigFile(configPath);
-            expect(result.format).toBe('yaml');
-            expect(result.data).toEqual(configData);
-        });
-    });
-    describe('Cache Statistics', () => {
-        it('should track cache size', async () => {
-            const configPath1 = path.join(testDir, 'config1.json');
-            const configPath2 = path.join(testDir, 'config2.json');
-            await fsp.writeFile(configPath1, JSON.stringify({ test1: 'value1' }));
-            await fsp.writeFile(configPath2, JSON.stringify({ test2: 'value2' }));
-            // Read both files
-            await readConfigFile(configPath1);
-            await readConfigFile(configPath2);
-            const stats = fsCache.getStats();
-            expect(stats.size).toBeGreaterThan(0);
-        });
-    });
-});
-//# sourceMappingURL=cache.spec.js.map