kctl-react 0.8.3__tar.gz → 0.9.0__tar.gz

{kctl_react-0.8.3 → kctl_react-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kctl-react
-Version: 0.8.3
+Version: 0.9.0
 Summary: Kodemeio React CLI — manage the kodemeio-react monorepo
 Requires-Python: >=3.12
 Requires-Dist: httpx>=0.28.0

{kctl_react-0.8.3 → kctl_react-0.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "kctl-react"
-version = "0.8.3"
+version = "0.9.0"
 description = "Kodemeio React CLI — manage the kodemeio-react monorepo"
 requires-python = ">=3.12"
 dependencies = [
@@ -43,3 +43,6 @@ line-length = 120
 [tool.mypy]
 python_version = "3.12"
 strict = true
+
+[tool.kctl-conform]
+exempt = ["LAYOUT-006"]  # monorepo/git/fs tool, no remote client

kctl_react-0.9.0/skills/react-admin/SKILL.md

@@ -0,0 +1,570 @@
+---
+name: react-admin
+description: >
+  React PWA monorepo management via kctl-react CLI (38 groups, ~179 commands). MUST use for ANY kctl-react operation. See SKILL.md ## Triggers for keywords.
+  Auto-generated: 2026-05-22
+  registry_hash: 72e20bc3438e
+---
+
+# react-admin — kctl-react CLI Reference
+
+> Auto-generated from `kctl-react` command registry. Do not edit manually.
+> To regenerate: `kctl-react skill generate`
+> To add custom content: edit `SKILL.extra.md` in the same directory.
+
+## Overview
+
+**CLI:** `kctl-react`
+**Command groups:** 38
+**Total commands:** ~179
+**Install:** `cd cli && uv tool install --editable .`
+
+## Global Options
+
+| Flag | Description |
+|------|-------------|
+| `--json` | JSON output |
+| `--quiet`, `-q` | Suppress info messages |
+| `--format`, `-f` | Output format: pretty/json/csv/yaml |
+| `--no-header` | Omit CSV header row |
+| `--profile`, `-p` | Config profile name |
+| `--version`, `-V` | Show version |
+
+## Quick Discovery (for AI agents)
+
+**DO NOT GUESS command paths or flag names.** Before invoking `kctl-react <group> <verb> ...`, use these AI-facing affordances:
+
+1. **Find a command by keyword** — substring filter, returns sorted leaf paths:
+   ```bash
+   kctl-react commands list --filter <keyword>
+   ```
+   Example: `kctl-react commands list --filter database` → all database-related commands in one call.
+
+2. **Inspect flags before invoking** — full param schema with
+   opts/defaults/required/choices/help:
+   ```bash
+   kctl-react commands tree --json | jq '.. | objects | select(.name == "<verb>") | .params'
+   ```
+   Reading the `params` array tells you exact flag names (`--lang`), short aliases (`-l`), defaults, required-vs-optional, and choices — eliminating the `No such option '--xxx'` failure mode.
+
+3. **Preview destructive operations without executing** — `--explain` is supported on selected write commands:
+   ```bash
+   kctl-react <group> <verb> <args> --explain
+   ```
+   Prints the planned action and exits 0. If `--explain` errors with "no such option", that command does not support it — fall back to verifying via `commands tree` schema inspection before running for real.
+
+4. **Errors are user-facing one-liners**, not Python tracebacks. A failed invocation shows `❌ <ErrorClass>: <message>` on stderr (or `{"error": ..., "message": ...}` JSON if `--json` was passed). Read the message — it usually tells you exactly what's missing.
+
+## Triggers
+
+Auto-invoke this skill when the user references any of these keywords:
+
+"a11y", "affected", "affected-gate", "anti-patterns", "api-check", "api-health", "apps", "audit", "budget", "build", "bundle", "cache", "cache-clear", "cache-list", "cap", "check", "chunks", "clean", "cleanup", "codegen", "commands", "compare", "completions", "compliance", "component", "components", "config", "consistency", "consumers", "conventions", "count", "count-test-files", "coverage", "current", "dashboard", "deploy", "deps", "deps-license", "deps-sync", "dev", "devices", "diff", "discover", "docker", "docs", "doctor", "down", "dr-status", "drift", "duplicates", "e2e", "emulator", "endpoints", "env", "errors", "fonts", "form", "format", "gate", "generate", "graph", "headers", "health", "health-report", "history", "hook", "hooks-audit", "i18n", "image-size", "images", "impact", "info", "init", "install", "installed", "interpolation", "invalidation-map", "kctl-react", "keystore", "launch"
+
+## Command Reference
+
+### `kctl-react a11y`
+
+Accessibility auditing (WCAG 2.1).
+
+| Command | Description |
+|---------|-------------|
+| `a11y audit <app_name> [--url]` | Run axe-core accessibility audit. |
+| `a11y report <app_name>` | Full WCAG 2.1 AA compliance report. |
+| `a11y violations <app_name> [--severity]` | List accessibility violations filtered by severity. |
+
+### `kctl-react affected`
+
+Git-aware change detection and targeted operations.
+
+| Command | Description |
+|---------|-------------|
+| `affected build [--base]` | Build only affected apps. |
+| `affected lint [--base]` | Lint only affected apps. |
+| `affected test [--base] [--coverage]` | Run tests only for affected apps. |
+
+### `kctl-react apps`
+
+App inventory, status, and health checks.
+
+| Command | Description |
+|---------|-------------|
+| `apps clean [--app_name] [--all_]` | Clean dist, .turbo, and coverage directories. |
+| `apps dashboard [--watch] [--interval]` | Show monorepo overview dashboard. |
+| `apps doctor` | Run comprehensive monorepo health checks. |
+| `apps health [--app_name] [--watch] [--interval]` | Check health of running dev servers. |
+| `apps info` | Show quick project info: version, root, profile, node/pnpm versions. |
+| `apps list` | List all apps with ports and package names. |
+| `apps ports` | Show port assignments for all apps. |
+| `apps status [--app_name]` | Check status of app(s): directory exists, package.json, env file, dist. |
+
+**Examples:**
+```bash
+kctl-react apps clean             # Clean all apps
+kctl-react apps clean sfa         # Clean SFA only
+kctl-react apps clean --all       # Clean + remove node_modules
+```
+
+### `kctl-react build`
+
+Production builds and bundle analysis.
+
+| Command | Description |
+|---------|-------------|
+| `build bundle <app_name> [--top]` | Show treemap-style bundle composition for a built app. |
+| `build chunks <app_name>` | Show chunk breakdown for a built app. |
+| `build compare [--app_name]` | Compare current bundle sizes against last recorded snapshot. |
+| `build history` | Show build size history over time. |
+| `build size [--app_name]` | Show bundle sizes for built app(s). |
+
+### `kctl-react bundle`
+
+Advanced bundle analysis.
+
+| Command | Description |
+|---------|-------------|
+| `bundle budget <app_name> [--max_js]` | Check bundle sizes against budgets. |
+| `bundle compare <app_name>` | Compare current build against saved snapshot. |
+| `bundle duplicates` | Detect packages bundled at different versions across apps. |
+| `bundle impact <app_name> [--top]` | Show which chunks contribute most to bundle size. |
+| `bundle treeshake <app_name>` | Detect imports that may prevent tree-shaking. |
+
+### `kctl-react cap`
+
+Capacitor native app management (Android/iOS).
+
+| Command | Description |
+|---------|-------------|
+| `cap add <app_name> <platform>` | Add a native platform (android/ios) to an app. |
+| `cap build <app_name> <platform> [--release]` | Build native artifact (APK/AAB for Android, IPA for iOS). |
+| `cap dev <app_name> <platform>` | Start Vite dev server with live-reload on a native device. |
+| `cap devices` | List connected Android devices and emulators via ADB. |
+| `cap doctor [--app_name] [--platform]` | Comprehensive Capacitor build environment validation. |
+| `cap emulator [--start] [--create]` | List, create, or start Android emulators. |
+| `cap init <app_name> [--app_id]` | Initialize Capacitor for an app (creates capacitor.config.ts). |
+| `cap install <app_name> [--device] [--build_type]` | Install APK on a connected device or emulator. |
+| `cap keystore <app_name> [--alias] [--validity]` | Generate a signing keystore for release builds. |
+| `cap launch <app_name> [--device]` | Launch the app on a connected device or emulator. |
+| `cap logs <app_name> [--device] [--clear]` | Show live logcat output filtered to the app (Ctrl+C to stop). |
+| `cap open <app_name> <platform>` | Open native project in Android Studio or Xcode. |
+| `cap run <app_name> <platform> [--target]` | Build, sync, and deploy to a device or emulator. |
+| `cap status` | Show Capacitor status for all apps. |
+| `cap sync <app_name> [--platform] [--skip_build]` | Build web assets and sync to native platforms. |
+
+### `kctl-react clean`
+
+Clean build artifacts and caches.
+
+| Command | Description |
+|---------|-------------|
+| `clean run [--app_name] [--all_]` | Clean dist, .turbo, and coverage directories. |
+
+**Examples:**
+```bash
+kctl-react clean run             # Clean all apps
+kctl-react clean run sfa         # Clean SFA only
+kctl-react clean run --all       # Clean + remove node_modules
+```
+
+### `kctl-react codegen`
+
+OpenAPI schema fetch and type generation.
+
+| Command | Description |
+|---------|-------------|
+| `codegen diff <app_name>` | Show what types changed after regenerating OpenAPI types. |
+| `codegen drift <app_name>` | Detect stale type references. |
+| `codegen endpoints <app_name>` | List API endpoints from the app's generated types. |
+| `codegen schema-health <app_name>` | Check OpenAPI codegen health for an app. |
+| `codegen status` | Show codegen setup status for each app. |
+| `codegen verify <app_name>` | Verify generated types are properly wired. |
+
+### `kctl-react commands`
+
+Machine-readable command discovery (for AI agents).
+
+| Command | Description |
+|---------|-------------|
+| `commands list [--json_flag] [--filter_substr]` | List all leaf commands as 'group verb' strings. |
+| `commands tree [--json_flag]` | Dump the full command tree as JSON. |
+
+### `kctl-react completions`
+
+Generate or install shell completions.
+
+Usage: `kctl-react completions [--shell] [--install]`
+
+### `kctl-react compliance`
+
+Audit app compliance, auto-fix violations, and generate fix prompts.
+
+| Command | Description |
+|---------|-------------|
+| `compliance api-check [--app_name] [--all_apps] [--offline] [--categories] [--min_score]` | Check frontend API hooks against OpenAPI schema. |
+| `compliance api-health [--app_name] [--all_apps] [--url] [--timeout] [--token] [--categories] [--min_score]` | Run live health checks against backend API endpoints. |
+| `compliance audit [--app_name] [--all_apps] [--min_score] [--categories]` | Run compliance audit on one or all apps. |
+| `compliance fix [--app_name] [--all_apps] [--dry_run] [--categories]` | Apply auto-fixes for compliance violations. |
+| `compliance prompt [--app_name] [--all_apps] [--output_file] [--categories]` | Generate markdown fix prompts for AI or human review. |
+
+**Examples:**
+```bash
+kctl-react compliance api-check sfa
+kctl-react compliance api-check --all
+kctl-react compliance api-check sfa --offline
+kctl-react compliance api-check sfa --categories endpoints,types
+kctl-react compliance api-check --all --min-score 80
+```
+
+### `kctl-react config`
+
+Manage CLI configuration and profiles.
+
+| Command | Description |
+|---------|-------------|
+| `config add <name> [--root] [--api_url] [--odoo_url] [--odoo_db] [--set_default]` | Add or update a profile's React monorepo connection. |
+| `config current` | Show the active profile and project root. |
+| `config init [--root] [--api_url] [--name]` | Initialize CLI configuration (interactive if no flags given). |
+| `config profiles` | List all profiles. |
+| `config remove <name> [--force] [--service_only]` | Remove a profile or just its React config. |
+| `config set <key> <value>` | Set a configuration value. |
+| `config show` | Show full configuration. |
+| `config test` | Verify configuration is valid. |
+| `config use <name>` | Switch the default profile. |
+
+### `kctl-react dashboard`
+
+Monorepo overview dashboard.
+
+| Command | Description |
+|---------|-------------|
+| `dashboard show [--watch] [--interval]` | Show monorepo overview dashboard. |
+
+### `kctl-react deploy`
+
+Docker Compose deployment management.
+
+| Command | Description |
+|---------|-------------|
+| `deploy build <app_name>` | Build and deploy an app via Docker Compose. |
+| `deploy down <app_name> [--force]` | Stop a deployed app. |
+| `deploy images` | Show Docker images for all apps. |
+| `deploy logs <app_name> [--follow]` | Show logs for a deployed app. |
+| `deploy ps` | Show all running containers for kodemeio apps. |
+| `deploy readiness` | Show deployment readiness status per app. |
+| `deploy status <app_name>` | Show container status for a deployed app. |
+
+### `kctl-react deps`
+
+Dependency management and analysis.
+
+| Command | Description |
+|---------|-------------|
+| `deps audit` | Run security audit on dependencies. |
+| `deps duplicates` | Find packages with inconsistent versions across workspaces. |
+| `deps graph` | Show internal package dependency graph. |
+| `deps health` | Run dependency health checks and produce an overall score. |
+| `deps list` | List all workspace packages. |
+| `deps outdated [--app_name]` | Check for outdated dependencies. |
+| `deps size` | Show node_modules disk usage. |
+| `deps stack [--category]` | Show full external dependency inventory across the monorepo. |
+| `deps sync [--fix]` | Check and fix version inconsistencies across ALL external dependencies. |
+| `deps upgrade [--category] [--major] [--dry_run]` | Smart dependency upgrade — show outdated deps with context and apply upgrades. |
+| `deps why <package>` | Show which apps depend on a specific package. |
+
+**Examples:**
+```bash
+kctl-react deps upgrade                  # Show upgrade plan
+kctl-react deps upgrade --category build # Only build tools
+kctl-react deps upgrade --major          # Include major bumps
+```
+
+### `kctl-react dev`
+
+Dev server management.
+
+| Command | Description |
+|---------|-------------|
+| `dev list` | List available apps and their dev ports. |
+| `dev logs <app_name>` | Show build output / dev logs for an app (re-runs dev with output). |
+| `dev start [--app_name]` | Start dev server(s) via Turbo. |
+
+**Examples:**
+```bash
+kctl-react dev start sfa     # Start SFA only
+kctl-react dev start         # Start all apps
+```
+
+### `kctl-react docker`
+
+Docker container management.
+
+| Command | Description |
+|---------|-------------|
+| `docker image-size` | Show Docker image sizes. |
+| `docker logs [--service] [--tail]` | Stream container logs. |
+| `docker ps` | List running containers. |
+| `docker restart <service>` | Restart a container. |
+
+### `kctl-react doctor`
+
+Monorepo health checks.
+
+| Command | Description |
+|---------|-------------|
+| `doctor check` | Run comprehensive monorepo health checks. |
+
+### `kctl-react e2e`
+
+E2E testing and screenshots via Playwright.
+
+| Command | Description |
+|---------|-------------|
+| `e2e discover [--dry_run] [--json_output]` | Auto-discover app configs and regenerate e2e/app-registry.ts. |
+| `e2e install` | Install Playwright browsers (chromium). |
+| `e2e list [--app_name]` | List all discovered E2E tests. |
+| `e2e report` | Open Playwright HTML test report. |
+| `e2e screenshots [--app_name] [--mobile] [--desktop]` | Capture screenshots of all app pages via Playwright. |
+| `e2e test [--app_name] [--headed] [--ui] [--shared_only] [--debug] [--screenshots] [--video] [--mobile] [--grep] [--api_only] [--pages_only]` | Run Playwright E2E tests. |
+
+**Examples:**
+```bash
+kctl-react e2e discover            # Regenerate registry
+kctl-react e2e discover --dry-run  # Preview changes
+kctl-react e2e discover --json     # Output as JSON
+kctl-react e2e install
+kctl-react e2e list          # List all tests
+```
+
+### `kctl-react env`
+
+Environment variable management.
+
+| Command | Description |
+|---------|-------------|
+| `env diff <app1> <app2>` | Compare .env files between two apps. |
+| `env show <app_name>` | Show environment variables for an app. |
+| `env validate [--app_name]` | Validate .env files exist and have required keys. |
+
+### `kctl-react i18n`
+
+Translation management (react-i18next).
+
+| Command | Description |
+|---------|-------------|
+| `i18n coverage [--app_name] [--all_apps]` | Translation coverage — compare en.json vs id.json. |
+| `i18n diff <app_name> [--base]` | Show keys added/removed between git refs. |
+| `i18n interpolation <app_name>` | Check {{var}} placeholder consistency between en.json and id.json. |
+| `i18n missing <app_name>` | List keys in en.json but not in id.json. |
+| `i18n sort <app_name>` | Sort translation JSON keys alphabetically. |
+| `i18n sync-stub <app_name>` | Generate stub entries in id.json for keys missing from en.json. |
+| `i18n unused <app_name>` | Find translation keys not referenced in source code. |
+| `i18n validate <app_name>` | Validate all translation JSON files for syntax and required keys. |
+
+### `kctl-react info`
+
+Show monorepo summary: apps, packages, and CLI version.
+
+### `kctl-react lint`
+
+Lint, type-check, and format code.
+
+| Command | Description |
+|---------|-------------|
+| `lint conventions <app_name>` | Check project conventions for an app. |
+| `lint format [--check]` | Run Prettier on the codebase. |
+| `lint strict-check` | Verify all apps have TypeScript strict mode enabled. |
+| `lint tsconfig-audit` | Audit tsconfig.json settings for consistency across all apps. |
+
+**Examples:**
+```bash
+kctl-react lint conventions sfa
+kctl-react lint strict-check
+kctl-react --json lint strict-check
+kctl-react lint tsconfig-audit
+```
+
+### `kctl-react maintenance`
+
+Maintenance utilities for the React monorepo.
+
+| Command | Description |
+|---------|-------------|
+| `maintenance cleanup [--dry_run]` | Remove build artifacts (dist/, .turbo/, coverage/, node_modules/.cache). |
+| `maintenance count-test-files` | Count test files (.test.ts / .test.tsx) per app. |
+| `maintenance deps-sync [--exclude]` | Check dependency version consistency across all apps and packages. |
+| `maintenance dr-status` | Check deployment readiness: Dockerfile, docker-compose, and .env files. |
+| `maintenance health-report` | Show per-app health: test file count, codegen status, and dist presence. |
+
+### `kctl-react monitor`
+
+Production monitoring.
+
+| Command | Description |
+|---------|-------------|
+| `monitor health <app_name> [--url]` | HTTP health check against deployed app. |
+| `monitor ssl <domain>` | Check SSL certificate. |
+
+### `kctl-react observe`
+
+Error tracking and observability.
+
+| Command | Description |
+|---------|-------------|
+| `observe errors [--app_name]` | Show error trends. |
+| `observe sentry [--app_name]` | Show recent Sentry issues. |
+| `observe uptime [--app_name]` | Show Gatus uptime status. |
+
+### `kctl-react packages`
+
+Shared package inspection and management.
+
+| Command | Description |
+|---------|-------------|
+| `packages consumers <package_name>` | Show which apps use a specific shared package. |
+| `packages list` | List all shared packages with versions and descriptions. |
+| `packages size` | Show source size of each shared package. |
+
+### `kctl-react perf`
+
+Performance profiling and bundle analysis.
+
+| Command | Description |
+|---------|-------------|
+| `perf bundle <app_name> [--budget_kb]` | Report bundle size breakdown for a built app (reads dist/assets/). |
+| `perf fonts <app_name>` | Check font loading strategy (preload, self-hosted, font-display, woff2). |
+| `perf history <app_name> [--limit]` | Show Lighthouse score and build size trends over time. |
+| `perf images <app_name> [--max_size]` | Audit image assets in public/ and src/assets/ directories. |
+| `perf lighthouse <app_name> [--budget] [--url]` | Run Lighthouse CI and compare against performance budget. |
+| `perf pwa [--app_name]` | Check PWA readiness for each app. |
+| `perf vitals <app_name>` | Check Core Web Vitals readiness (code splitting, lazy images, SVGs, scripts). |
+
+### `kctl-react pipeline`
+
+CI/CD pipeline gates, affected builds, and releases.
+
+| Command | Description |
+|---------|-------------|
+| `pipeline affected-gate [--base] [--strict]` | Run gate only for apps affected by git changes. |
+| `pipeline gate [--app_name] [--strict] [--skip_build]` | Run full CI gate: lint → type-check → test → audit → build. |
+| `pipeline release <app_name> [--tag] [--push]` | Build Docker image for an app and optionally push to GHCR. |
+
+### `kctl-react pwa`
+
+PWA and Service Worker management (Vite apps).
+
+| Command | Description |
+|---------|-------------|
+| `pwa cache-clear <app_name>` | Clear built service worker files. |
+| `pwa cache-list <app_name>` | List precached URLs from service worker manifest. |
+| `pwa manifest-validate <app_name>` | Validate web app manifest against PWA requirements. |
+| `pwa offline-report <app_name>` | Analyze offline support coverage. |
+| `pwa status <app_name>` | Show PWA status — service worker version, precache count, manifest. |
+| `pwa sw-info <app_name>` | Show vite-plugin-pwa configuration. |
+
+### `kctl-react scaffold`
+
+Scaffold new apps, pages, hooks, and components.
+
+| Command | Description |
+|---------|-------------|
+| `scaffold component <app_name> <name>` | Scaffold a new component. |
+| `scaffold form <app_name> <name>` | Scaffold a react-hook-form + zod form component. |
+| `scaffold hook <app_name> <resource>` | Scaffold a TanStack Query API hook. |
+| `scaffold page <app_name> <name>` | Scaffold a new page component. |
+| `scaffold test <app_name> <name>` | Scaffold a vitest test file. |
+
+### `kctl-react security`
+
+Security scanning and compliance checks.
+
+| Command | Description |
+|---------|-------------|
+| `security audit [--app_name] [--detail]` | Run pnpm audit — show vulnerabilities with severity, CVEs, and fix commands. |
+| `security deps-license [--app_name] [--check]` | Check license compliance across dependencies. |
+| `security headers <app_name> [--url]` | Check security headers on a running app. |
+| `security licenses [--app_name] [--check]` | Check license compliance across dependencies. |
+| `security report [--app_name] [--strict]` | Run all security checks and produce an aggregated report. |
+| `security scan [--app_name]` | Combined security scan: dependency audit + secret detection. |
+| `security secrets [--app_name]` | Scan source code for hardcoded API keys, tokens, and passwords. |
+
+### `kctl-react self-update`
+
+Check for updates and upgrade kctl-react.
+
+### `kctl-react skill`
+
+Claude Code skill management.
+
+| Command | Description |
+|---------|-------------|
+| `skill generate [--output] [--install]` | Auto-generate SKILL.md from CLI command registry. |
+
+### `kctl-react state`
+
+TanStack Query static analysis (query keys, hooks audit, invalidation map).
+
+| Command | Description |
+|---------|-------------|
+| `state consistency <app_name>` | Check query key consistency — duplicates and mutations missing invalidation. |
+| `state hooks-audit <app_name>` | Audit hook best practices — imports, onError handlers, getErrorMessage usage. |
+| `state invalidation-map <app_name>` | Show mutation → invalidation mapping for all hook files. |
+| `state query-keys <app_name>` | List all TanStack Query queryKey definitions in hook files and inline queries. |
+
+### `kctl-react test`
+
+Run tests across the monorepo.
+
+| Command | Description |
+|---------|-------------|
+| `test count` | Count test files per app. |
+| `test coverage` | Show aggregated test coverage across all apps. |
+| `test naming` | Check test file naming conventions across all apps. |
+| `test snapshots <app_name>` | List vitest snapshot files for an app. |
+| `test summary [--app_name]` | Run tests with JSON reporter and show parsed summary. |
+| `test threshold [--min_pct]` | Enforce minimum coverage threshold across all apps. |
+
+### `kctl-react tui`
+
+Launch the interactive TUI.
+
+Usage: `kctl-react tui [--profile]`
+
+### `kctl-react ui`
+
+UI component audit and shadcn compliance.
+
+| Command | Description |
+|---------|-------------|
+| `ui add [--component] [--all_components] [--overwrite] [--dry_run]` | Install a shadcn component into @kodemeio/ui. |
+| `ui anti-patterns <app_name>` | Detect React anti-patterns: inline styles, CSS modules, styled-components, direct DOM access. |
+| `ui audit <app_name>` | Find raw HTML elements that should be shadcn components. |
+| `ui compliance <app_name>` | Score shadcn compliance as % of clean TSX files (no violations). |
+| `ui components <app_name>` | List shadcn components used by the app. |
+| `ui diff <component>` | Show diff for a shadcn component update. |
+| `ui docs <component>` | Get shadcn component documentation and API reference. |
+| `ui info` | Show shadcn project configuration from packages/ui. |
+| `ui installed` | List all installed shadcn components in @kodemeio/ui. |
+| `ui preset <name> [--reinstall] [--dry_run] [--target]` | Apply a shadcn theme preset — extract CSS vars into the monorepo theme system. |
+| `ui search <query> [--limit]` | Search the shadcn component registry. |
+| `ui theme-check <app_name>` | Validate theme CSS variable references and Tailwind v4 patterns. |
+| `ui unused` | Find installed components not used by any app. |
+
+**Examples:**
+```bash
+kctl-react ui preset b1D0dv72                     # Apply to base-neutral.css
+kctl-react ui preset b1D0dv72 --target sfa        # Apply to themes/sfa.css
+kctl-react ui preset b1D0dv72 --dry-run           # Preview changes
+kctl-react ui preset b1D0dv72 --reinstall         # Apply + reinstall components
+```
+
+## Configuration
+
+Shared config: `~/.config/kodemeio/config.yaml`
+
+```bash
+kctl-react config init       # Interactive setup
+kctl-react config show       # Show current config
+kctl-react config profiles   # List profiles
+kctl-react config current    # Show active profile
+kctl-react config validate   # Verify config
+```

{kctl_react-0.8.3 → kctl_react-0.9.0}/src/kctl_react/__init__.py

@@ -1,3 +1,3 @@
 """kctl-react: Kodemeio React Monorepo CLI."""
 
-__version__ = "0.8.3"
+__version__ = "0.9.0"

kctl_react-0.9.0/src/kctl_react/_register.py

@@ -0,0 +1,85 @@
+"""Command-group registration for kctl-react (extracted from cli.py to keep it thin)."""
+
+from __future__ import annotations
+
+import typer
+from kctl_lib.ai_summary import add_ai_summary_command
+from kctl_lib.tui import add_tui_command
+
+from kctl_react import __version__
+from kctl_react.commands.a11y import app as a11y_app
+from kctl_react.commands.affected import app as affected_app
+from kctl_react.commands.apps import app as apps_app
+from kctl_react.commands.build import app as build_app
+from kctl_react.commands.bundle_cmd import app as bundle_app
+from kctl_react.commands.cap import app as cap_app
+from kctl_react.commands.clean import app as clean_app
+from kctl_react.commands.compliance import app as compliance_app
+from kctl_react.commands.codegen import app as codegen_app
+from kctl_react.commands.config_cmd import app as config_app
+from kctl_react.commands.dashboard import app as dashboard_app
+from kctl_react.commands.deploy import app as deploy_app
+from kctl_react.commands.deps import app as deps_app
+from kctl_react.commands.dev import app as dev_app
+from kctl_react.commands.docker_cmd import app as docker_app
+from kctl_react.commands.doctor import app as doctor_app
+from kctl_react.commands.doctor_cmd import build_checks as doctor_build_checks
+from kctl_react.commands.e2e import app as e2e_app
+from kctl_react.commands.env import app as env_app
+from kctl_react.commands.i18n import app as i18n_app
+from kctl_react.commands.lint import app as lint_app
+from kctl_react.commands.maintenance import app as maintenance_app
+from kctl_react.commands.monitor_cmd import app as monitor_app
+from kctl_react.commands.observe import app as observe_app
+from kctl_react.commands.packages import app as packages_app
+from kctl_react.commands.perf import app as perf_app
+from kctl_react.commands.pipeline import app as pipeline_app
+from kctl_react.commands.pwa import app as pwa_app
+from kctl_react.commands.scaffold import app as scaffold_app
+from kctl_react.commands.security import app as security_app
+from kctl_react.commands.skill_cmd import app as skill_app
+from kctl_react.commands.state import app as state_app
+from kctl_react.commands.test_cmd import app as test_app
+from kctl_react.commands.ui_audit import app as ui_audit_app
+
+
+def register_all(app: typer.Typer) -> None:
+    """Register all command groups on *app* in the canonical order."""
+    # Register all command groups
+    app.add_typer(affected_app, name="affected")
+    app.add_typer(apps_app, name="apps")
+    app.add_typer(build_app, name="build")
+    app.add_typer(cap_app, name="cap")
+    app.add_typer(clean_app, name="clean")
+    app.add_typer(codegen_app, name="codegen")
+    app.add_typer(compliance_app, name="compliance")
+    app.add_typer(config_app, name="config")
+    app.add_typer(dashboard_app, name="dashboard")
+    app.add_typer(deploy_app, name="deploy")
+    app.add_typer(deps_app, name="deps")
+    app.add_typer(dev_app, name="dev")
+    app.add_typer(doctor_app, name="doctor")
+    add_ai_summary_command(
+        doctor_app, cli_name="kctl-react", version=__version__, app=app, get_checks=doctor_build_checks
+    )
+    app.add_typer(e2e_app, name="e2e")
+    app.add_typer(env_app, name="env")
+    app.add_typer(lint_app, name="lint")
+    app.add_typer(packages_app, name="packages")
+    app.add_typer(perf_app, name="perf")
+    app.add_typer(pipeline_app, name="pipeline")
+    app.add_typer(scaffold_app, name="scaffold")
+    app.add_typer(security_app, name="security")
+    app.add_typer(test_app, name="test")
+    app.add_typer(pwa_app, name="pwa")
+    app.add_typer(a11y_app, name="a11y")
+    app.add_typer(i18n_app, name="i18n")
+    app.add_typer(ui_audit_app, name="ui")
+    app.add_typer(state_app, name="state")
+    app.add_typer(bundle_app, name="bundle")
+    app.add_typer(observe_app, name="observe")
+    app.add_typer(docker_app, name="docker")
+    app.add_typer(monitor_app, name="monitor")
+    app.add_typer(maintenance_app, name="maintenance")
+    app.add_typer(skill_app, name="skill")
+    add_tui_command(app, service_key="react", version=__version__)