@tdk-landscape/tdk-cli-core 1.3.14

package/README.md

@@ -0,0 +1,293 @@
+# 🚀 TDK CLI
+
+> **T**ilt **D**evelopment **K**it - All-in-one local development platform for microservices
+
+[![npm version](https://img.shields.io/npm/v/@tdk/cli.svg?style=flat&color=blue)](https://www.npmjs.com/package/@tdk/cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 🎯 What is TDK?
+
+TDK CLI organizes your microservices using a clear **Project-Stack-Resource (PSR)** hierarchy:
+
+```
+📁 Project (1 per repo)
+├── ⚙️  TILT_RESOURCE_DEFAULTS.star   # Ports, health checks, memory
+├── 🔧 TILT_TECH_STACK.star          # Bun, Vite, Prisma, NATS
+│
+└── 📦 Stacks (deployment groups)
+    ├── 🔐 api-stack
+    │   ├── ⚡ api-backend      # Resource
+    │   └── 🎨 web-frontend     # Resource
+    │
+    └── 📅 worker-stack
+        ├── ⚡ worker-backend    # Resource
+        └── 🎨 web-frontend     # Resource
+```
+
+---
+
+## 📦 Installation
+
+```bash
+npm install -g @tdk/cli
+# or
+bun install -g @tdk/cli
+```
+
+---
+
+## 🏗️ 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 <resource>` | 🚀 Start specific resource | `tdk up api-backend` |
+| `tdk down` | ⏹️ Stop all services | `tdk down` |
+| `tdk status` | 📊 Show resource status | `tdk status` |
+
+---
+
+## 🛠️ Utility Commands
+
+| Command | Description |
+|---------|-------------|
+| `tdk ui` | 🎨 Interactive terminal UI |
+| `tdk doctor` | 🔍 Check environment (Docker, Bun, Tilt, ports) |
+| `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 |
+
+---
+
+## 🔒 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
+
+---
+
+## 📁 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 Documentation](https://github.com/tdk-landscape/tdk-cli/tree/main/docs)
+- [Architecture](https://github.com/tdk-landscape/tdk-cli/tree/main/engine/docs)
+- [Tilt Extension](https://github.com/tdk-landscape/tdk-cli#using-as-tilt-extension)
+
+---
+
+## 📝 License
+
+MIT © [TDK Landscape](https://github.com/tdk-landscape)
+
+---
+
+<div align="center">
+
+**[⬆️ Back to Top](#-tdk-cli)**
+
+Made with 💚 for developers who ship
+
+</div>

package/bin/tdk.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const cliPath = join(__dirname, "..", "dist", "cli.js");
+
+import(cliPath).catch((err) => {
+  console.error("Failed to start TDK:", err);
+  process.exit(1);
+});

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import chalk from "chalk";
+import { Command } from "commander";
+import pkg from "../package.json" with { type: "json" };
+import { completionCommand } from "./commands/completion.js";
+import { configCommand } from "./commands/config.js";
+import { doctorCommand } from "./commands/doctor.js";
+import { downCommand } from "./commands/down.js";
+import { showHelp } from "./commands/help.js";
+import { networksCommand } from "./commands/networks.js";
+import { projectCommand } from "./commands/project.js";
+import { projectsCommand } from "./commands/projects.js";
+import { resourceCommand } from "./commands/resource.js";
+import { resourcesCommand } from "./commands/resources.js";
+import { stackCommand } from "./commands/stack.js";
+import { stacksCommand } from "./commands/stacks.js";
+import { statusCommand } from "./commands/status.js";
+import { uiCommand } from "./commands/ui.js";
+import { upCommand } from "./commands/up.js";
+import { upgradeCommand } from "./commands/upgrade.js";
+import { versionCommand } from "./commands/version.js";
+const program = new Command();
+program
+    .name("tdk")
+    .description("Tilt Development Kit - Project/Stack/Resource management")
+    .version(pkg.version, "-v, --version", "Display version number")
+    .option("--verbose", "Enable verbose output", false)
+    .configureOutput({
+    outputError: (str, write) => write(chalk.red(str)),
+    writeOut: (str) => process.stdout.write(str),
+    writeErr: (str) => process.stderr.write(str),
+});
+program.helpCommand("help [command]", "Show colorful help").on("--help", () => {
+    showHelp();
+    process.exit(0);
+});
+program.addHelpText("before", "");
+program.addCommand(stacksCommand);
+program.addCommand(resourcesCommand);
+program.addCommand(projectsCommand);
+program.addCommand(upCommand);
+program.addCommand(downCommand);
+program.addCommand(statusCommand);
+program.addCommand(stackCommand);
+program.addCommand(resourceCommand);
+program.addCommand(projectCommand);
+program.addCommand(configCommand);
+program.addCommand(uiCommand);
+program.addCommand(versionCommand);
+program.addCommand(doctorCommand);
+program.addCommand(completionCommand);
+program.addCommand(upgradeCommand);
+program.addCommand(networksCommand);
+// Default: show help if no command provided
+if (process.argv.length === 2) {
+    showHelp();
+    process.exit(0);
+}
+if (process.argv.length === 3 && ["-h", "--help", "help"].includes(process.argv[2])) {
+    showHelp();
+    process.exit(0);
+}
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,0DAA0D,CAAC;KACvE,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,wBAAwB,CAAC;KAC/D,MAAM,CAAC,WAAW,EAAE,uBAAuB,EAAE,KAAK,CAAC;KACnD,eAAe,CAAC;IACf,WAAW,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClD,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;IAC5C,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;CAC7C,CAAC,CAAC;AAEL,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IAC5E,QAAQ,EAAE,CAAC;IACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAElC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAC9B,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAC9B,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACtC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AAEpC,4CAA4C;AAC5C,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC9B,QAAQ,EAAE,CAAC;IACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,QAAQ,EAAE,CAAC;IACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/completion.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const completionCommand: Command;
+//# sourceMappingURL=completion.d.ts.map

package/dist/commands/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuNpC,eAAO,MAAM,iBAAiB,SAgF1B,CAAC"}

package/dist/commands/completion.js

@@ -0,0 +1,294 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import chalk from "chalk";
+import { Command } from "commander";
+const BASH_COMPLETION = `# TDK CLI Bash Completion
+_tdk_completions() {
+    local cur prev opts
+    COMPREPLY=()
+    cur="\${COMP_WORDS[COMP_CWORD]}"
+    prev="\${COMP_WORDS[COMP_CWORD-1]}"
+    
+    # Main commands
+    local commands="project projects stack stacks resource resources up down status ui doctor version completion help upgrade"
+    
+    # Options for specific commands
+    case "\${prev}" in
+        tdk)
+            COMPREPLY=( $(compgen -W "\${commands}" -- \${cur}) )
+            return 0
+            ;;
+        up)
+            # Complete with stack names and resource names
+            local stacks=$(tdk stacks 2>/dev/null | grep '^  -' | sed 's/^  - //' | awk '{print $1}')
+            local resources=$(tdk resources 2>/dev/null | grep -E '^[a-z0-9-]+' | awk '{print $1}')
+            COMPREPLY=( $(compgen -W "\${stacks} \${resources}" -- \${cur}) )
+            return 0
+            ;;
+        stack)
+            # Complete with existing stack names
+            local stacks=$(tdk stacks 2>/dev/null | grep '^  -' | sed 's/^  - //' | awk '{print $1}')
+            COMPREPLY=( $(compgen -W "\${stacks}" -- \${cur}) )
+            return 0
+            ;;
+        resource)
+            # Suggest common resource names or types
+            COMPREPLY=( $(compgen -W "api frontend backend worker --type --stack" -- \${cur}) )
+            return 0
+            ;;
+        --type)
+            COMPREPLY=( $(compgen -W "backend frontend worker" -- \${cur}) )
+            return 0
+            ;;
+        --stack)
+            local stacks=$(tdk stacks 2>/dev/null | grep '^  -' | sed 's/^  - //' | awk '{print $1}')
+            COMPREPLY=( $(compgen -W "\${stacks}" -- \${cur}) )
+            return 0
+            ;;
+    esac
+    
+    # Global options
+    if [[ \${cur} == -* ]]; then
+        local options="--verbose --version --help --force --dry-run"
+        COMPREPLY=( $(compgen -W "\${options}" -- \${cur}) )
+        return 0
+    fi
+}
+
+complete -F _tdk_completions tdk
+`;
+const ZSH_COMPLETION = `#compdef tdk
+
+# TDK CLI Zsh Completion
+
+_tdk() {
+    local curcontext="$curcontext" state line
+    typeset -A opt_args
+    
+    _arguments -C 
+        '(-h --help)'{-h,--help}'[Show help]' 
+        '(-v --version)'{-v,--version}'[Show version]' 
+        '--verbose[Enable verbose output]' 
+        '1: :_tdk_commands' 
+        '*:: :->args'
+    
+    case "$line[1]" in
+        up)
+            _arguments 
+                '--verbose[Enable verbose output]'
+                '1: :_tdk_stacks_and_resources'
+            ;;
+        stack)
+            _arguments 
+                '--list[List resources without a stack]'
+                '1: :_tdk_stacks'
+            ;;
+        stacks)
+            _arguments 
+                '--services[Include resources in each stack]'
+            ;;
+        resource)
+            _arguments 
+                '--type[Resource type]:type:(backend frontend worker)' 
+                '--stack[Assign to stack]:stack:_tdk_stacks' 
+                '1:resource name:'
+            ;;
+        resources)
+            _arguments 
+                '--stack[Filter by stack]:stack:_tdk_stacks' 
+                '--no-stack[Show unassigned only]' 
+                '--ports[Show port assignments]'
+            ;;
+        projects)
+            _arguments 
+                '--check[Validate master configs]'
+            ;;
+        doctor)
+            _arguments 
+                '--fix[Attempt to fix issues]'
+            ;;
+        upgrade)
+            _arguments
+                '--force[Force upgrade even if on latest]'
+                '--dry-run[Show what would be upgraded]'
+            ;;
+    esac
+}
+
+_tdk_commands() {
+    local commands=(
+        'project:Initialize project with master configs'
+        'projects:Show project information'
+        'stack:Organize resources into stacks'
+        'stacks:List all stacks'
+        'resource:Create new resource'
+        'resources:List all resources'
+        'up:Start services'
+        'down:Stop all services'
+        'status:Show resource status'
+        'ui:Open interactive UI'
+        'doctor:Check environment'
+        'version:Show version'
+        'upgrade:Upgrade TDK CLI'
+        'completion:Generate shell completions'
+        'help:Show help'
+    )
+    _describe -t commands 'tdk command' commands
+}
+
+_tdk_stacks() {
+    local stacks
+    stacks=($(tdk stacks 2>/dev/null | grep '^  -' | sed 's/^  - //' | awk '{print $1}'))
+    _describe -t stacks 'stack' stacks
+}
+
+_tdk_resources() {
+    local resources
+    resources=($(tdk resources 2>/dev/null | grep -E '^[a-z0-9-]+' | awk '{print $1}'))
+    _describe -t resources 'resource' resources
+}
+
+_tdk_stacks_and_resources() {
+    _tdk_stacks
+    _tdk_resources
+}
+
+compdef _tdk tdk
+`;
+const FISH_COMPLETION = `# TDK CLI Fish Completion
+
+# Disable file completions for most commands
+complete -c tdk -f
+
+# Main commands
+complete -c tdk -n '__fish_use_subcommand' -a 'project' -d 'Initialize project with master configs'
+complete -c tdk -n '__fish_use_subcommand' -a 'projects' -d 'Show project information'
+complete -c tdk -n '__fish_use_subcommand' -a 'stack' -d 'Organize resources into stacks'
+complete -c tdk -n '__fish_use_subcommand' -a 'stacks' -d 'List all stacks'
+complete -c tdk -n '__fish_use_subcommand' -a 'resource' -d 'Create new resource'
+complete -c tdk -n '__fish_use_subcommand' -a 'resources' -d 'List all resources'
+complete -c tdk -n '__fish_use_subcommand' -a 'up' -d 'Start services'
+complete -c tdk -n '__fish_use_subcommand' -a 'down' -d 'Stop all services'
+complete -c tdk -n '__fish_use_subcommand' -a 'status' -d 'Show resource status'
+complete -c tdk -n '__fish_use_subcommand' -a 'ui' -d 'Open interactive UI'
+complete -c tdk -n '__fish_use_subcommand' -a 'doctor' -d 'Check environment'
+complete -c tdk -n '__fish_use_subcommand' -a 'version' -d 'Show version'
+complete -c tdk -n '__fish_use_subcommand' -a 'upgrade' -d 'Upgrade TDK CLI'
+complete -c tdk -n '__fish_use_subcommand' -a 'completion' -d 'Generate shell completions'
+complete -c tdk -n '__fish_use_subcommand' -a 'help' -d 'Show help'
+
+# Global options
+complete -c tdk -s h -l help -d 'Show help'
+complete -c tdk -s v -l version -d 'Show version'
+complete -c tdk -l verbose -d 'Enable verbose output'
+
+# Command-specific completions
+# resource command options
+complete -c tdk -n '__fish_seen_subcommand_from resource' -l type -d 'Resource type' -a 'backend frontend worker'
+complete -c tdk -n '__fish_seen_subcommand_from resource' -l stack -d 'Assign to stack' -a '(tdk stacks 2>/dev/null | string match -r "^  - " | string replace "  - " "")'
+
+# resources command options
+complete -c tdk -n '__fish_seen_subcommand_from resources' -l stack -d 'Filter by stack' -a '(tdk stacks 2>/dev/null | string match -r "^  - " | string replace "  - " "")'
+complete -c tdk -n '__fish_seen_subcommand_from resources' -l no-stack -d 'Show unassigned only'
+complete -c tdk -n '__fish_seen_subcommand_from resources' -l ports -d 'Show port assignments'
+
+# stack command options
+complete -c tdk -n '__fish_seen_subcommand_from stack' -l list -d 'List resources without a stack'
+
+# stacks command options
+complete -c tdk -n '__fish_seen_subcommand_from stacks' -l services -d 'Include resources in each stack'
+
+# projects command options
+complete -c tdk -n '__fish_seen_subcommand_from projects' -l check -d 'Validate master configs'
+
+# up command completions
+complete -c tdk -n '__fish_seen_subcommand_from up' -a '(tdk stacks 2>/dev/null | string match -r "^  - " | string replace "  - " "")'
+complete -c tdk -n '__fish_seen_subcommand_from up' -a '(tdk resources 2>/dev/null | string match -r "^[a-z0-9-]+")'
+
+# doctor command options
+complete -c tdk -n '__fish_seen_subcommand_from doctor' -l fix -d 'Attempt to fix issues'
+
+# upgrade command options
+complete -c tdk -n '__fish_seen_subcommand_from upgrade' -l force -d 'Force upgrade even if on latest'
+complete -c tdk -n '__fish_seen_subcommand_from upgrade' -l dry-run -d 'Show what would be upgraded'
+`;
+export const completionCommand = new Command("completion")
+    .description("Generate shell completion scripts")
+    .option("-s, --shell <shell>", "Target shell (bash, zsh, fish)", "bash")
+    .option("-o, --output <path>", "Output file path (default: stdout)")
+    .option("--install", "Install to shell config automatically")
+    .action((options) => {
+    const shell = options.shell.toLowerCase();
+    let completionScript;
+    let filename;
+    switch (shell) {
+        case "bash":
+            completionScript = BASH_COMPLETION;
+            filename = "tdk-completion.bash";
+            break;
+        case "zsh":
+            completionScript = ZSH_COMPLETION;
+            filename = "_tdk";
+            break;
+        case "fish":
+            completionScript = FISH_COMPLETION;
+            filename = "tdk.fish";
+            break;
+        default:
+            console.error(chalk.red(`❌ Unsupported shell: ${shell}`));
+            console.log(chalk.gray("Supported shells: bash, zsh, fish"));
+            process.exit(1);
+    }
+    if (options.install) {
+        const home = homedir();
+        let installPath;
+        let installInstructions;
+        switch (shell) {
+            case "bash": {
+                installPath = join(home, ".bash_completion.d", filename);
+                const bashDir = join(home, ".bash_completion.d");
+                if (!existsSync(bashDir)) {
+                    mkdirSync(bashDir, { recursive: true });
+                }
+                installInstructions = `\n# Add to ~/.bashrc:\nsource ~/.bash_completion.d/${filename}`;
+                break;
+            }
+            case "zsh": {
+                installPath = join(home, ".zsh", "completions", filename);
+                const zshDir = join(home, ".zsh", "completions");
+                if (!existsSync(zshDir)) {
+                    mkdirSync(zshDir, { recursive: true });
+                }
+                installInstructions =
+                    "\n# Add to ~/.zshrc:\nfpath+=(~/.zsh/completions)\nautoload -U compinit && compinit";
+                break;
+            }
+            case "fish": {
+                installPath = join(home, ".config", "fish", "completions", filename);
+                const fishDir = join(home, ".config", "fish", "completions");
+                if (!existsSync(fishDir)) {
+                    mkdirSync(fishDir, { recursive: true });
+                }
+                installInstructions = "\n# Fish completions loaded automatically";
+                break;
+            }
+            default:
+                installPath = "";
+                installInstructions = "";
+        }
+        writeFileSync(installPath, completionScript, "utf-8");
+        console.log(chalk.green(`✅ Installed ${shell} completion to:`));
+        console.log(chalk.cyan(`   ${installPath}`));
+        console.log(chalk.yellow(installInstructions));
+    }
+    else if (options.output) {
+        writeFileSync(options.output, completionScript, "utf-8");
+        console.log(chalk.green(`✅ Written ${shell} completion to:`));
+        console.log(chalk.cyan(`   ${options.output}`));
+    }
+    else {
+        console.log(completionScript);
+    }
+});
+//# sourceMappingURL=completion.js.map