@vyuhlabs/dxkit 2.4.8 → 2.5.1

package/templates/.claude/skills/scaffold/SKILL.md.template

@@ -1,123 +0,0 @@
----
-name: scaffold
-description: Scaffold new code — services, packages, modules, components. Use when asked to create new files, modules, project structure, or boilerplate.
----
-
-# Code Scaffolding
-
-## Project Structure
-- `.project.yaml` - Central config (edit via `make config`, view via `make info`)
-- `.project/` - Framework tooling and scripts
-- `.ai/` - AI session management and checkpoints
-
-## Language Management
-- `make lang-list` - Show enabled languages
-- `make lang-add LANG=<name>` - Enable a language
-- `make lang-remove LANG=<name>` - Disable a language
-- `make sync` - Sync `.project.yaml` to language config files
-- `make sync-preview` - Preview sync changes (dry run)
-
-{{#IF_PYTHON}}
-## Python Structure
-```
-services/python/<service-name>/
-├── pyproject.toml
-├── src/
-│   ├── __init__.py
-│   ├── app.py          # Entry point / app factory
-│   ├── models.py       # Data models (Pydantic)
-│   └── routes.py       # API endpoints (if web)
-└── tests/
-    ├── __init__.py
-    └── test_app.py
-```
-
-**Patterns:**
-- FastAPI for web APIs (app factory pattern)
-- Pydantic for data validation
-- pytest for testing
-- See `.template/examples/python-api/` and `.template/examples/python-cli/` for reference
-{{/IF_PYTHON}}
-
-{{#IF_GO}}
-## Go Structure
-```
-services/go/<service-name>/
-├── go.mod
-├── main.go             # Entry point
-├── handlers.go         # HTTP handlers
-├── handlers_test.go    # Handler tests
-└── internal/           # Private packages
-```
-
-**Patterns:**
-- Standard library `net/http` for HTTP
-- `httptest` for handler testing
-- See `.template/examples/go-service/` for reference
-{{/IF_GO}}
-
-{{#IF_NEXTJS}}
-## Next.js Structure
-```
-frontend/
-├── src/
-│   ├── app/            # App Router pages
-│   ├── components/     # React components
-│   └── lib/            # Utilities
-├── public/             # Static assets
-├── package.json
-└── tsconfig.json
-```
-{{/IF_NEXTJS}}
-
-{{#IF_NODE}}
-## Node.js Structure
-```
-services/node/<service-name>/
-├── package.json
-├── tsconfig.json
-├── src/
-│   └── index.ts
-└── tests/
-    └── index.test.ts
-```
-{{/IF_NODE}}
-
-{{#IF_RUST}}
-## Rust Structure
-```
-services/rust/<service-name>/
-├── Cargo.toml
-├── src/
-│   ├── main.rs         # Binary entry
-│   └── lib.rs          # Library code
-└── tests/
-    └── integration.rs
-```
-{{/IF_RUST}}
-
-{{#IF_CSHARP}}
-## C# Structure
-```
-src/<ProjectName>/
-├── <ProjectName>.csproj
-├── Program.cs
-├── Controllers/      # API controllers
-├── Models/           # Data models
-├── Services/         # Business logic
-└── appsettings.json  # Configuration
-tests/<ProjectName>.Tests/
-├── <ProjectName>.Tests.csproj
-└── UnitTests/
-```
-
-**Patterns:**
-- ASP.NET Core for web APIs (minimal APIs or controllers)
-- Entity Framework Core for data access
-- xUnit + Moq for testing
-{{/IF_CSHARP}}
-
-## After Scaffolding
-1. Run `make sync` to update config files
-2. Run `make doctor` to verify setup
-3. Run `make test` to confirm everything works

package/templates/.claude/skills/secrets/SKILL.md

@@ -1,52 +0,0 @@
----
-name: secrets
-description: Manage secrets via Infisical. Use when asked about secrets, environment variables, API keys, .env configuration, or credential management.
-paths:
-  - '.env'
-  - '.env.*'
-  - '**/.env'
-  - '**/.env.*'
-  - '.infisical.json'
-  - '**/.infisical.json'
----
-
-# Secrets Management (Infisical)
-
-## Commands
-- `make secrets-pull` - Pull secrets from Infisical to `.env`
-- `make secrets-show` - Show Infisical configuration (**no secrets displayed**)
-- `make setup` - Configure Infisical during initial setup
-
-## How It Works
-1. Infisical stores secrets centrally (encrypted, access-controlled)
-2. `make secrets-pull` fetches secrets and merges into `.env`
-3. `.env` is gitignored — **never commit secrets**
-
-## Configuration
-Required in `.env` (set during `make setup`):
-- `INFISICAL_TOKEN` - Authentication token
-- `INFISICAL_PROJECT_ID` - Project identifier
-- `INFISICAL_ENV` - Environment (default: `dev`)
-
-## Checking Configuration
-Always use `make secrets-show` — it displays config keys without values:
-```
-INFISICAL_PROJECT_ID=abc123
-INFISICAL_ENV=dev
-INFISICAL_TOKEN=***configured***
-```
-
-## Security — CRITICAL
-
-1. **NEVER read `.env` directly** — it contains plain-text secrets
-2. **NEVER output secret values** in responses, logs, or commit messages
-3. **NEVER include secrets** in session checkpoints or skill files
-4. **NEVER pass secrets as CLI arguments** — they appear in process lists
-5. **NEVER commit** `.env`, `.env.*`, or `.env.secrets`
-6. Use `make secrets-show` to verify configuration without exposing values
-7. If a secret is accidentally exposed, rotate it immediately
-
-## Troubleshooting
-- Token expired → re-authenticate via `make setup`
-- Pull fails → check `make secrets-show` for config, verify token permissions
-- Missing env var → check if it exists in Infisical project, correct environment

package/templates/.claude/skills/session/SKILL.md

@@ -1,43 +0,0 @@
----
-name: session
-description: Manage AI development sessions — start, checkpoint, commit, push, create PRs. Use when asked about session workflow, checkpoints, or development workflow.
----
-
-# Session Management
-
-## Workflow
-1. `make session-start` - Start session (finds last checkpoint, generates prompts)
-2. Work on your task using step-by-step development
-3. `make session-end` - Create checkpoint document
-4. `make session-commit` - Commit with quality checks
-5. `make session-push` - Push to remote
-6. `make session-pr` - Create PR with auto-generated content
-
-## Key Files
-- `.ai/prompts/session-start.md` - Planning prompt template
-- `.ai/prompts/session-end.md` - Checkpoint creation guide
-- `.ai/prompts/step-by-step.md` - Step-by-step development guide
-- `.ai/templates/session-checkpoint-template.md` - Checkpoint structure
-
-## Checkpoints
-- Stored in: `.ai/sessions/<developer>/<date>/session-<N>.md`
-- Auto-numbered per day
-- Include: accomplishments, files, decisions, next steps, AI context
-
-## Checkpoint Quality
-A good checkpoint is specific, not vague:
-- **Bad:** "worked on the client"
-- **Good:** "Implemented PolygonClient with 3 endpoints, added 15 unit tests, all passing"
-
-## Skill Evolution (during session-end)
-After creating the checkpoint, review the session for learnings:
-- Append gotchas to `.claude/skills/learned/references/gotchas.md`
-- Append conventions to `.claude/skills/learned/references/conventions.md`
-- Update area-specific gotchas in `.claude/skills/<area>/references/gotchas.md`
-- **Create new skills** if a distinct domain/workflow emerged (new `.claude/skills/<name>/SKILL.md`)
-
-**NEVER include secret values in checkpoints or skill files.**
-
-## Tips
-- `SKIP_VERIFY=1` on session-commit/push to bypass quality checks for WIP
-- `BASE=main` on session-pr to override base branch

package/templates/.claude/skills/test/SKILL.md.template

@@ -1,122 +0,0 @@
----
-name: test
-description: Run tests, check coverage, debug test failures. Use when asked to run tests, write tests, investigate test failures, or check coverage.
-paths:
-  - '**/*.test.ts'
-  - '**/*.test.tsx'
-  - '**/*.test.js'
-  - '**/*.test.jsx'
-  - '**/*.spec.ts'
-  - '**/*.spec.tsx'
-  - '**/*.spec.js'
-  - '**/*_test.go'
-  - '**/test_*.py'
-  - '**/*_test.py'
-  - '**/tests/**'
-  - '**/__tests__/**'
----
-
-# Testing
-
-## Commands
-- `make test` - Run all tests (report: `tmp/reports/test-report.md`)
-- `make test-unit` - Fast unit tests only (no coverage)
-- `make test-quick` - Alias for test-unit
-- `make test-integration` - Integration tests only
-- `make test-coverage` - Detailed coverage report
-- Coverage threshold: **{{COVERAGE_THRESHOLD}}%**
-
-{{#IF_PYTHON}}
-## Python
-
-**Framework:** pytest (config: `pytest.ini`, `pyproject.toml`)
-**Coverage:** pytest-cov
-**Pattern:** `tests/` directories alongside source
-
-```bash
-pytest tests/ -v                    # run all
-pytest tests/test_foo.py -v         # run specific
-pytest tests/ -k "test_name" -v    # run by name
-pytest tests/ --cov=src --cov-report=term-missing  # with coverage
-```
-
-Writing tests:
-- Use fixtures for setup/teardown
-- Use `@pytest.mark.parametrize` for data-driven tests
-- Mock external dependencies with `unittest.mock` or `pytest-mock`
-- Use dependency injection for testability
-{{/IF_PYTHON}}
-
-{{#IF_GO}}
-## Go
-
-**Framework:** `go test`
-**Coverage:** `go test -coverprofile`
-**Pattern:** `_test.go` files alongside source
-
-```bash
-go test ./... -v                          # run all
-go test ./pkg/mypackage/ -v               # run specific
-go test ./... -run TestName -v            # run by name
-go test ./... -coverprofile=coverage.out  # with coverage
-go tool cover -html=coverage.out          # view coverage
-```
-
-Writing tests:
-- Use table-driven tests for multiple cases
-- Use `httptest` for HTTP handler tests
-- Use `testify/assert` if available, otherwise standard `testing`
-{{/IF_GO}}
-
-{{#IF_NEXTJS}}
-## Next.js
-
-**Framework:** Jest (if configured)
-**Directory:** `frontend/`
-
-```bash
-cd frontend && npm test
-cd frontend && npm test -- --coverage
-```
-{{/IF_NEXTJS}}
-
-{{#IF_RUST}}
-## Rust
-
-```bash
-cargo test                    # run all
-cargo test test_name          # run specific
-cargo test -- --nocapture     # show output
-```
-{{/IF_RUST}}
-
-{{#IF_CSHARP}}
-## C#
-
-**Framework:** xUnit (preferred), NUnit, MSTest
-**Coverage:** coverlet
-**Pattern:** `*.Tests` projects alongside source
-
-```bash
-dotnet test                                              # run all
-dotnet test --filter "FullyQualifiedName~TestName"       # run specific
-dotnet test --collect:"XPlat Code Coverage"              # with coverage
-```
-
-Writing tests:
-- Use `[Fact]` for single assertions, `[Theory]` with `[InlineData]` for data-driven
-- Use dependency injection + mocking (Moq, NSubstitute)
-- Follow Arrange-Act-Assert pattern
-{{/IF_CSHARP}}
-
-## Writing Tests
-
-- Every new feature should include tests
-- Aim for coverage threshold ({{COVERAGE_THRESHOLD}}%)
-- Use dependency injection for mockability
-- Test edge cases and error paths, not just happy paths
-- Integration tests go in separate directories/files from unit tests
-
-## Gotchas
-
-See [references/gotchas.md](references/gotchas.md) for known test issues.

package/templates/.claude/skills/test/references/gotchas.md

@@ -1,5 +0,0 @@
-# Test Gotchas
-
-<!-- This file grows over time. Each entry is added during session-end. -->
-<!-- Format: date, category, description, resolution -->
-<!-- NEVER include secret values, tokens, or credentials here -->

package/templates/.devcontainer/Dockerfile.dev.template

@@ -1,89 +0,0 @@
-# Generated from template - do not edit directly
-# Regenerate with: ./scripts/bootstrap/bootstrap.sh
-
-FROM mcr.microsoft.com/vscode/devcontainers/base:ubuntu-22.04
-
-# Install system dependencies
-RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
-    && apt-get -y install --no-install-recommends \
-        build-essential \
-        curl \
-        git \
-        wget \
-        unzip \
-        ca-certificates \
-        jq \
-{{#IF_POSTGRES}}
-        postgresql-client \
-{{/IF_POSTGRES}}
-{{#IF_REDIS}}
-        redis-tools \
-{{/IF_REDIS}}
-    && apt-get autoremove -y && apt-get clean -y
-
-{{#IF_GO}}
-# ============================================================================
-# Go {{GO_VERSION}}
-# ============================================================================
-RUN wget -q https://golang.org/dl/go{{GO_VERSION}}.linux-amd64.tar.gz \
-    && tar -C /usr/local -xzf go{{GO_VERSION}}.linux-amd64.tar.gz \
-    && rm go{{GO_VERSION}}.linux-amd64.tar.gz
-
-ENV PATH="/usr/local/go/bin:${PATH}"
-ENV GOPATH="/go"
-ENV GOBIN="/go/bin"
-ENV PATH="${PATH}:${GOBIN}"
-
-# Create Go workspace
-RUN mkdir -p /go/src /go/bin /go/pkg && chmod -R 777 /go
-
-{{/IF_GO}}
-{{#IF_PYTHON}}
-# ============================================================================
-# Python {{PYTHON_VERSION}}
-# ============================================================================
-# Note: We use ensurepip instead of apt's python3-pip because:
-# 1. It installs pip for the specific Python version, not the system Python
-# 2. Python 3.12+ removed distutils which breaks the system pip package
-RUN apt-get update && apt-get install -y software-properties-common \
-    && add-apt-repository ppa:deadsnakes/ppa -y \
-    && apt-get update \
-    && apt-get install -y \
-        python{{PYTHON_VERSION}} \
-        python{{PYTHON_VERSION}}-dev \
-        python{{PYTHON_VERSION}}-venv \
-    && update-alternatives --install /usr/bin/python3 python3 /usr/bin/python{{PYTHON_VERSION}} 1 \
-    && update-alternatives --install /usr/bin/python python /usr/bin/python{{PYTHON_VERSION}} 1 \
-    && python{{PYTHON_VERSION}} -m ensurepip --upgrade \
-    && python{{PYTHON_VERSION}} -m pip install --upgrade pip
-
-{{/IF_PYTHON}}
-{{#IF_NODE}}
-# ============================================================================
-# Node.js {{NODE_VERSION}}
-# ============================================================================
-RUN curl -fsSL https://deb.nodesource.com/setup_{{NODE_VERSION}}.x | bash - \
-    && apt-get install -y nodejs
-
-{{/IF_NODE}}
-{{#IF_RUST}}
-# ============================================================================
-# Rust {{RUST_VERSION}}
-# ============================================================================
-RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain {{RUST_VERSION}}
-ENV PATH="/root/.cargo/bin:${PATH}"
-
-{{/IF_RUST}}
-# ============================================================================
-# Utility Tools
-# ============================================================================
-
-# Install yq for YAML processing
-RUN wget -qO /usr/local/bin/yq https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 \
-    && chmod +x /usr/local/bin/yq
-
-# Set the default user
-USER vscode
-
-# Set working directory
-WORKDIR /workspaces/{{PROJECT_NAME}}

package/templates/.devcontainer/devcontainer.json.template

@@ -1,184 +0,0 @@
-{
-  "name": "{{PROJECT_NAME}} Development Environment",
-  "dockerComposeFile": "docker-compose.yml",
-  "service": "dev-environment",
-  "workspaceFolder": "/workspaces/{{PROJECT_NAME}}",
-  "shutdownAction": "stopCompose",
-
-  "features": {
-    "ghcr.io/devcontainers/features/sshd:1": {
-      "version": "latest"
-    },
-    "ghcr.io/devcontainers/features/git:1": {
-      "version": "latest",
-      "ppa": false
-    }{{#IF_DOCKER}},
-    "ghcr.io/devcontainers/features/docker-in-docker:2": {
-      "version": "latest",
-      "moby": true,
-      "dockerDashComposeVersion": "v2"
-    }{{/IF_DOCKER}}
-  },
-
-  "postCreateCommand": "bash .devcontainer/post-create.sh",
-
-  "customizations": {
-    "vscode": {
-      "extensions": [
-        "ms-azuretools.vscode-docker",
-        "ms-vscode.makefile-tools",
-        "EditorConfig.EditorConfig",
-        "eamodio.gitlens",
-        "usernamehw.errorlens",
-        "gruntfuggly.todo-tree",
-{{#IF_CLAUDE_CODE}}
-        "anthropic.claude-code",
-{{/IF_CLAUDE_CODE}}
-{{#IF_PYTHON}}
-        "ms-python.python",
-        "ms-python.vscode-pylance",
-        "charliermarsh.ruff",
-        "ms-python.black-formatter",
-{{/IF_PYTHON}}
-{{#IF_GO}}
-        "golang.go",
-{{/IF_GO}}
-{{#IF_NODE}}
-        "dbaeumer.vscode-eslint",
-        "esbenp.prettier-vscode",
-{{/IF_NODE}}
-{{#IF_NEXTJS}}
-        "bradlc.vscode-tailwindcss",
-        "csstools.postcss",
-{{/IF_NEXTJS}}
-{{#IF_RUST}}
-        "rust-lang.rust-analyzer",
-{{/IF_RUST}}
-{{#IF_POSTGRES}}
-        "mtxr.sqltools",
-        "mtxr.sqltools-driver-pg",
-{{/IF_POSTGRES}}
-{{#IF_REDIS}}
-        "cweijan.vscode-redis-client",
-{{/IF_REDIS}}
-        "redhat.vscode-yaml",
-        "yzhang.markdown-all-in-one"
-      ],
-      "settings": {
-        "terminal.integrated.defaultProfile.linux": "bash",
-        "terminal.integrated.scrollback": 10000,
-        "editor.formatOnSave": true,
-        "editor.rulers": [88, 120],
-        "editor.tabSize": 4,
-        "editor.insertSpaces": true,
-        "files.trimTrailingWhitespace": true,
-        "files.insertFinalNewline": true,
-{{#IF_PYTHON}}
-        "python.defaultInterpreterPath": "/usr/bin/python{{PYTHON_VERSION}}",
-        "python.formatting.provider": "none",
-        "[python]": {
-          "editor.defaultFormatter": "charliermarsh.ruff",
-          "editor.formatOnSave": true,
-          "editor.codeActionsOnSave": {
-            "source.fixAll.ruff": "explicit",
-            "source.organizeImports.ruff": "explicit"
-          }
-        },
-{{/IF_PYTHON}}
-{{#IF_GO}}
-        "go.gopath": "/go",
-        "go.goroot": "/usr/local/go",
-        "go.formatTool": "goimports",
-        "go.lintTool": "golangci-lint",
-        "go.lintOnSave": "package",
-        "[go]": {
-          "editor.formatOnSave": true,
-          "editor.codeActionsOnSave": {
-            "source.organizeImports": "explicit"
-          }
-        },
-{{/IF_GO}}
-{{#IF_NODE}}
-        "[javascript]": {
-          "editor.defaultFormatter": "esbenp.prettier-vscode"
-        },
-        "[typescript]": {
-          "editor.defaultFormatter": "esbenp.prettier-vscode"
-        },
-        "[json]": {
-          "editor.defaultFormatter": "esbenp.prettier-vscode"
-        },
-{{/IF_NODE}}
-{{#IF_NEXTJS}}
-        "[typescriptreact]": {
-          "editor.defaultFormatter": "esbenp.prettier-vscode"
-        },
-        "[css]": {
-          "editor.defaultFormatter": "esbenp.prettier-vscode"
-        },
-        "tailwindCSS.includeLanguages": {
-          "typescript": "javascript",
-          "typescriptreact": "javascript"
-        },
-{{/IF_NEXTJS}}
-{{#IF_RUST}}
-        "[rust]": {
-          "editor.formatOnSave": true,
-          "editor.defaultFormatter": "rust-lang.rust-analyzer"
-        },
-        "rust-analyzer.checkOnSave.command": "clippy",
-{{/IF_RUST}}
-{{#IF_POSTGRES}}
-        "sqltools.connections": [
-          {
-            "name": "{{PROJECT_NAME}} Dev DB",
-            "driver": "PostgreSQL",
-            "server": "db",
-            "port": 5432,
-            "database": "{{DB_NAME}}",
-            "username": "{{DB_USER}}",
-            "password": "{{DB_PASSWORD}}"
-          }
-        ],
-{{/IF_POSTGRES}}
-        "files.associations": {
-          "*.env*": "dotenv",
-          "Makefile*": "makefile"
-        }
-      }
-    }
-  },
-
-  "forwardPorts": [
-    8080,
-    3000{{#IF_POSTGRES}},
-    5432{{/IF_POSTGRES}}{{#IF_REDIS}},
-    6379{{/IF_REDIS}}
-  ],
-
-  "portsAttributes": {
-    "8080": {
-      "label": "API Server",
-      "onAutoForward": "notify"
-    },
-    "3000": {
-      "label": "Frontend Dev Server",
-      "onAutoForward": "notify"
-    }{{#IF_POSTGRES}},
-    "5432": {
-      "label": "PostgreSQL",
-      "onAutoForward": "silent"
-    }{{/IF_POSTGRES}}{{#IF_REDIS}},
-    "6379": {
-      "label": "Redis",
-      "onAutoForward": "silent"
-    }{{/IF_REDIS}}
-  },
-
-  "containerEnv": {
-    "PROJECT_NAME": "{{PROJECT_NAME}}",
-    "ENVIRONMENT": "development"
-  },
-
-  "remoteUser": "vscode"
-}