@tdk-landscape/tdk-cli-core 1.3.52 → 1.3.54

package/cli/README.md

@@ -1,292 +0,0 @@
-# 🚀 TDK CLI reference
-
-> Command reference for the `tdk` CLI. For what TDK is, installation, badges, and the benchmark, see the **[main README](../README.md)**.
-
----
-
-## 🏗️ Project-Stack-Resource Commands
-
-### 🌍 Project Level
-
-Initialize your project with master configuration files:
-
-```bash
-# 🆕 Initialize project (creates master configs)
-tdk project
-
-# 📊 Check project info and config status
-tdk projects              # Overview
-
-tdk projects --check      # ✅ CI validation (exit 0/1)
-```
-
-**Creates:**
-- ⚙️ `TILT_RESOURCE_DEFAULTS.star` — Platform config (ports 3000-4999, health checks, memory limits)
-- 🔧 `TILT_TECH_STACK.star` — Tech stack lock (Bun v1.2, Vite v5, Prisma v7, NATS v2)
-
----
-
-### 📦 Stack Level
-
-Organize resources into deployment groups:
-
-```bash
-# 📋 List all stacks
-tdk stacks
-tdk stacks --services     # 🔍 Include resources in each stack
-
-# 🗂️  Organize resources into stacks (interactive)
-tdk stack api
-tdk stack order
-
-# ▶️ Start/stop a stack
-tdk up api           # 🚀 Start api stack
-tdk down                  # ⏹️  Stop all services
-```
-
----
-
-### ⚡ Resource Level
-
-Create and manage individual services:
-
-```bash
-# 📋 List all resources
-tdk resources
-tdk resources --stack api     # 🔍 Filter by stack
-tdk resources --no-stack           # ⚠️ Show unassigned only
-tdk resources --ports              # 🔌 Show port assignments
-
-# 🆕 Create new resource (interactive)
-tdk resource my-api --type backend --stack api
-tdk resource my-app --type frontend --stack api
-tdk resource my-worker --type worker --stack background
-```
-
-**Creates:**
-- 📄 `service.json` — Auto-assigned port from master config
-- 📦 `package.json` — Scripts, dependencies (Hono/Vite/Biome)
-- ⚙️ `tsconfig.json` — TypeScript configuration
-- 🐳 `Dockerfile` — Multi-stage build with health checks
-- 💻 `src/` — Starter code (Hono for backend, React for frontend)
-- 🧪 `tests/` — Vitest test file
-
----
-
-## 🔄 Lifecycle Commands
-
-| Command | Description | Example |
-|---------|-------------|---------|
-| `tdk up` | 🚀 Start all services | `tdk up` |
-| `tdk up <stack>` | 🚀 Start a stack | `tdk up api` |
-| `tdk up --dry-run` | 👀 Show what would start, without starting | `tdk up api --dry-run` |
-| `tdk down` | ⏹️ Stop all services | `tdk down` |
-| `tdk status` | 📊 Show resource status | `tdk status` |
-
----
-
-## 🛠️ Utility Commands
-
-| Command | Description |
-|---------|-------------|
-| `tdk ui` | 🎨 Interactive terminal UI |
-| `tdk networks` | 🌐 Show Traefik-routed URLs (`--stack`, `--json`, `--raw`) |
-| `tdk config regenerate` | ♻️ Regenerate master config files from `.tdk/project.json` |
-| `tdk config verify` | ✅ Check generated files match `.tdk/project.json` |
-| `tdk config enable-infra <service>` | ➕ Enable an optional infrastructure service (`disable-infra` to turn it off) |
-| `tdk doctor` | 🔍 Check environment (Docker, Bun, Tilt, ports) |
-| `tdk completion --install` | ⌨️ Install shell completions (`--shell bash\|zsh\|fish`) |
-| `tdk upgrade` | ⬆️ Self-update to the latest version (`--dry-run`, `--force`) |
-| `tdk version` | ℹ️  Show version |
-| `tdk --help` | ❓ Show help |
-
----
-
-## 🚀 Quick Start Workflow
-
-```bash
-# 1️⃣  Initialize project
-cd my-project
-tdk project
-
-# 2️⃣  Create resources
-tdk resource api-api --type backend --stack api
-# → Creates service.json with port 4000
-# → Generates src/index.ts with Hono starter
-# → Creates Dockerfile, tests/, package.json
-
-tdk resource api-app --type frontend --stack api
-# → Creates service.json with port 3000
-# → Generates React starter with Vite
-
-# 3️⃣  Install dependencies
-cd api-api && bun install
-cd ../api-app && bun install
-
-# 4️⃣  Start development
-tdk up api
-
-# 5️⃣  Check status
-tdk status
-tdk resources --stack api
-```
-
----
-
-## 📊 PSR Command Matrix
-
-| Level | 🔨 Create/Action | 📋 List |
-|-------|------------------|---------|
-| **🌍 Project** | `tdk project` | `tdk projects` |
-| **📦 Stack** | `tdk stack` | `tdk stacks` |
-| **⚡ Resource** | `tdk resource` | `tdk resources` |
-
----
-
-## 🎨 Resource Types
-
-| Type | Port Range | Template | Use Case |
-|------|------------|----------|----------|
-| `backend` | 4000-4999 | 🏎️ Hono API | REST APIs, microservices |
-| `frontend` | 3000-3999 | ⚛️ React + Vite | Web apps, dashboards |
-| `worker` | (optional) | 🔧 Background worker | Queue processors, jobs |
-| `sdk` | — | none (register existing, `packages/<name>`) | Shared libraries |
-
----
-
-## 🔒 Deterministic Operations
-
-Use `Determinism` in your Tiltfile for reproducible builds:
-
-```starlark
-load('ext://tdk-cli', 'Determinism')
-
-# Deterministic file discovery (sorted results)
-files = Determinism.deterministic_find('./services', 'service.json')
-
-# Deterministic service discovery
-services = Determinism.deterministic_resource_discovery(['services/product'])
-
-# Check deterministic mode
-if Determinism.is_deterministic_mode():
-    print("✅ Running in deterministic mode")
-```
-
----
-
-## 🔍 Environment Validation
-
-```bash
-🔧 tdk doctor
-```
-
-Checks for:
-- ✅ Docker daemon running
-- ✅ Bun runtime installed (v1.2+)
-- ✅ Tilt CLI available
-- ✅ Required ports free
-- ✅ Tiltfile present
-- ✅ Master config files exist
-- ✅ Docker Engine 25+ and Docker Compose 2.20.2+ (generated healthchecks use `start_interval`)
-
-### Container footprint
-
-Generated runtimes are sized so large landscapes fit on a 16 GB laptop:
-
-- **One process per container.** A service whose `start` script is just `bun run <file>` runs `bun <file>` directly under Docker's init (`init: true`). Any other `start` script keeps `bun run start`.
-- **Healthchecks:** every 2 s during startup, then every 30 s. You can override the timing for a run:
-
-  ```bash
-  TDK_HEALTHCHECK_INTERVAL_SECONDS=15 tdk up
-  ```
-
-  The other overrides are `TDK_HEALTHCHECK_START_INTERVAL_SECONDS`, `TDK_HEALTHCHECK_TIMEOUT_SECONDS`, `TDK_HEALTHCHECK_START_PERIOD_SECONDS` and `TDK_HEALTHCHECK_RETRIES`.
-- **Optional tooling is per service.** The golden backend image no longer ships `hugo`. A service that needs it declares it in `service.json`:
-
-  ```json
-  { "featuresEnabled": ["hugo"] }
-  ```
-
-To check a running backend against the idle budget (one Bun process, at most 64 MiB, under 2% CPU):
-
-```bash
-scripts/measure-idle-footprint.sh finance-autogenerated-cash-management-api-1
-```
-
----
-
-## 📁 Project Structure
-
-After `tdk project` + `tdk resource`:
-
-```
-my-project/
-├── ⚙️ TILT_RESOURCE_DEFAULTS.star
-├── 🔧 TILT_TECH_STACK.star
-├── 📄 Tiltfile
-│
-├── services/
-│   └── api/
-│       ├── api-api/           # 🆕 Created by tdk resource
-│       │   ├── service.json      # Port 4000, stack: api
-│       │   ├── package.json
-│       │   ├── tsconfig.json
-│       │   ├── Dockerfile
-│       │   ├── src/
-│       │   │   └── index.ts      # Hono starter
-│       │   └── tests/
-│       │       └── api-api.test.ts
-│       │
-│       └── api-app/         # 🆕 Created by tdk resource
-│           ├── service.json      # Port 3000, stack: api
-│           ├── package.json
-│           ├── tsconfig.json
-│           ├── Dockerfile
-│           ├── index.html
-│           └── src/
-│               ├── main.tsx
-│               └── App.tsx
-│
-└── workers/
-    └── notification-worker/      # 🆕 Created by tdk resource
-        └── ...
-```
-
----
-
-## 🆘 Getting Help
-
-```bash
-# General help
-tdk --help
-
-# Command help
-tdk resource --help
-tdk stack --help
-tdk up --help
-```
-
----
-
-## 📚 Documentation
-
-- [Main README](../README.md)
-- [Feature flags](../docs/FEATURES.md)
-- [Architecture](../engine/docs/README.md)
-- [Tilt Extension](../ext/)
-
----
-
-## 📝 License
-
-[MIT](../LICENSE) © [TDK Landscape](https://github.com/tdk-landscape)
-
----
-
-<div align="center">
-
-**[⬆️ Back to Top](#-tdk-cli-reference)**
-
-Made with 💚 for developers who ship
-
-</div>

package/cli/biome.json

@@ -1,40 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/2.5.14/schema.json",
-  "files": {
-    "ignoreUnknown": false,
-    "includes": ["**", "!**/node_modules", "!**/dist", "!**/*.lockb", "!**/*.svg"]
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 100
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "preset": "recommended",
-      "style": {
-        "noRestrictedImports": {
-          "level": "error",
-          "options": {
-            "patterns": [
-              {
-                "group": ["@tdk-landscape/*-backend", "@tdk-landscape/*-frontend"],
-                "message": "❌ tdk-cli is a leaf dev tool: it must never import a service package. See BOUNDARIES.md §4-5."
-              }
-            ]
-          }
-        }
-      }
-    }
-  },
-  "assist": {
-    "actions": {
-      "source": {
-        "organizeImports": "on"
-      }
-    },
-    "enabled": true
-  }
-}