@tdk-landscape/tdk-cli-core 1.3.44 → 1.3.48

package/package.json

@@ -1,76 +1,39 @@
 {
   "name": "@tdk-landscape/tdk-cli-core",
-  "version": "1.3.44",
-  "description": "TDK CLI - Tilt Development Kit command line interface",
+  "version": "1.3.48",
+  "description": "TDK CLI - Tilt Development Kit (monorepo)",
+  "private": false,
+  "workspaces": [
+    "cli"
+  ],
+  "bin": {
+    "tdk": "cli/bin/tdk.js",
+    "tdk-cli": "cli/bin/tdk.js"
+  },
+  "scripts": {
+    "build": "cd cli && npm run build",
+    "build:watch": "cd cli && npm run build:watch",
+    "typecheck": "cd cli && npm run typecheck",
+    "lint": "cd cli && npm run lint",
+    "lint:fix": "cd cli && npm run lint:fix",
+    "test": "cd cli && npm run test",
+    "clean": "cd cli && npm run clean",
+    "release:binaries": "scripts/release-binaries.sh",
+    "release:binaries:publish": "scripts/release-binaries.sh --publish",
+    "prepare": "scripts/install-git-hooks.sh",
+    "cli": "cd cli && node bin/tdk.js",
+    "tdk": "cd cli && node bin/tdk.js"
+  },
   "keywords": [
     "tdk",
     "tilt",
     "cli",
-    "local-dev",
-    "microservices"
+    "microservices",
+    "local-dev"
   ],
-  "homepage": "https://github.com/tdk-landscape/tdk-cli-core#readme",
-  "bugs": {
-    "url": "https://github.com/tdk-landscape/tdk-cli-core/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tdk-landscape/tdk-cli-core.git",
-    "directory": "cli"
-  },
   "license": "MIT",
-  "author": "TDK Team",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "tdk": "bin/tdk.js",
-    "tdk-cli": "bin/tdk.js"
-  },
-  "files": [
-    "dist",
-    "bin",
-    "templates",
-    "README.md",
-    "Tiltfile",
-    "engine",
-    "discovery",
-    "specs",
-    "ext"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "build:watch": "tsc --watch",
-    "lint": "biome check .",
-    "lint:fix": "biome check . --write",
-    "typecheck": "tsc --project tsconfig.typecheck.json",
-    "clean": "rm -rf dist",
-    "dev": "bun run build:watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepack": "../scripts/stage-npm-engine.sh && npm run build"
-  },
-  "dependencies": {
-    "chalk": "^5.3.0",
-    "commander": "^12.0.0",
-    "handlebars": "^4.7.8",
-    "ink": "^7.0.1",
-    "ink-select-input": "^6.2.0",
-    "ora": "^8.0.0",
-    "react": "^19.2.5"
-  },
   "devDependencies": {
-    "@biomejs/biome": "^2.5.13",
-    "@types/react": "^19.2.14",
-    "@types/inquirer": "^9.0.0",
     "@types/node": "^20.0.0",
-    "knip": "^6.35.1",
-    "react-devtools-core": "^6.1.1",
-    "typescript": "^7.0.2",
-    "vite": "^6.0.0",
-    "vitest": "^5.0.0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
+    "knip": "^6.9.0"
   }
 }

package/platform/services/platform/proxy/service.yaml

@@ -0,0 +1,14 @@
+appName: proxy
+appType: infra
+stack: platform
+port: 80
+description: Traefik reverse proxy with dynamic routing
+features:
+  - traefik
+healthCheck: False
+dependsOn:
+  - database-management
+runtime: docker
+traefik:
+  host: traefik.beauty-crm.localhost
+  pathPrefix: /dashboard

package/scripts/audit-codebase.sh

@@ -0,0 +1,213 @@
+#!/usr/bin/env bash
+#
+# TDK Codebase Audit Script
+# Scans for TODO, FIXME, BUG, HACK markers across all source files
+#
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+GREEN='\033[0;32m'
+GRAY='\033[0;90m'
+NC='\033[0m' # No Color
+
+# Directories to scan
+CLI_DIR="cli/src"
+DISCOVERY_DIR="discovery"
+ENGINE_DIR="engine"
+
+# File extensions to scan
+TS_EXTENSIONS="*.ts *.tsx"
+PY_EXTENSIONS="*.py"
+STAR_EXTENSIONS="*.star"
+GO_EXTENSIONS="*.go"
+
+# Markers to search for
+MARKERS="TODO|FIXME|XXX|BUG|HACK"
+
+echo -e "${BLUE}🔍 TDK Codebase Audit${NC}"
+echo -e "${GRAY}Scanning for: ${MARKERS}${NC}"
+echo ""
+
+# Counters
+cli_count=0
+discovery_count=0
+engine_count=0
+total_count=0
+
+# Temporary files for categorization
+CLI_FINDINGS=$(mktemp)
+DISCOVERY_FINDINGS=$(mktemp)
+ENGINE_FINDINGS=$(mktemp)
+
+# Function to scan a directory
+scan_directory() {
+    local dir="$1"
+    local name="$2"
+    local extensions="$3"
+    local output_file="$4"
+    local count=0
+
+    echo -e "${BLUE}📁 Scanning ${name}...${NC}"
+
+    if [ ! -d "$dir" ]; then
+        echo -e "${YELLOW}   ⚠️  Directory not found: ${dir}${NC}"
+        return 0
+    fi
+
+    for ext in $extensions; do
+        while IFS= read -r file; do
+            if [ -n "$file" ]; then
+                local findings=$(grep -n -E "${MARKERS}" "$file" 2>/dev/null || true)
+                if [ -n "$findings" ]; then
+                    echo "$file" >> "$output_file"
+                    echo "$findings" >> "$output_file"
+                    echo "" >> "$output_file"
+                    local file_count=$(echo "$findings" | wc -l)
+                    count=$((count + file_count))
+                fi
+            fi
+        done < <(find "$dir" -name "$ext" -type f 2>/dev/null)
+    done
+
+    echo -e "${GREEN}   ✅ Found ${count} marker(s)${NC}"
+    return $count
+}
+
+# Scan CLI (TypeScript)
+scan_directory "$CLI_DIR" "CLI (TypeScript)" "$TS_EXTENSIONS" "$CLI_FINDINGS"
+cli_count=$?
+
+# Scan Discovery (Python and Starlark)
+scan_directory "$DISCOVERY_DIR" "Discovery (Python/Starlark)" "$PY_EXTENSIONS $STAR_EXTENSIONS" "$DISCOVERY_FINDINGS"
+discovery_count=$?
+
+# Scan Engine (Starlark)
+scan_directory "$ENGINE_DIR" "Engine (Starlark)" "$STAR_EXTENSIONS $GO_EXTENSIONS" "$ENGINE_FINDINGS"
+engine_count=$?
+
+# Calculate total
+total_count=$((cli_count + discovery_count + engine_count))
+
+echo ""
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo -e "${BLUE}📊 AUDIT REPORT${NC}"
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo ""
+
+# Category: CLI (User-facing)
+echo -e "${YELLOW}🔴 CLI (User-Facing) - ${cli_count} finding(s)${NC}"
+echo -e "${GRAY}   These affect user commands and should be prioritized${NC}"
+if [ -s "$CLI_FINDINGS" ]; then
+    cat "$CLI_FINDINGS"
+fi
+echo ""
+
+# Category: Core (Discovery/Engine)
+echo -e "${YELLOW}🟡 Core (Discovery/Engine) - $((discovery_count + engine_count)) finding(s)${NC}"
+echo -e "${GRAY}   Infrastructure code - affects service discovery and orchestration${NC}"
+
+if [ -s "$DISCOVERY_FINDINGS" ]; then
+    echo -e "${BLUE}   Discovery:${NC}"
+    cat "$DISCOVERY_FINDINGS"
+fi
+
+if [ -s "$ENGINE_FINDINGS" ]; then
+    echo -e "${BLUE}   Engine:${NC}"
+    cat "$ENGINE_FINDINGS"
+fi
+echo ""
+
+# Summary
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo -e "${BLUE}📈 SUMMARY${NC}"
+echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
+echo -e "Total markers found: ${total_count}"
+echo ""
+echo -e "By category:"
+echo -e "  - CLI (User-facing):     ${cli_count}"
+echo -e "  - Discovery:              ${discovery_count}"
+echo -e "  - Engine:                ${engine_count}"
+echo ""
+
+if [ $total_count -eq 0 ]; then
+    echo -e "${GREEN}✨ No technical debt markers found!${NC}"
+else
+    echo -e "${YELLOW}⚠️  Action required: Review and address findings above${NC}"
+fi
+
+# Save report to file
+REPORT_FILE="codebase-audit-report-$(date +%Y%m%d-%H%M%S).md"
+cat > "$REPORT_FILE" << EOF
+# TDK Codebase Audit Report
+
+Generated: $(date)
+
+## Summary
+
+- **Total markers found:** ${total_count}
+- **CLI (User-facing):** ${cli_count}
+- **Discovery:** ${discovery_count}
+- **Engine:** ${engine_count}
+
+## Findings
+
+### CLI (User-Facing) - Priority: HIGH
+
+\`\`\`
+EOF
+
+if [ -s "$CLI_FINDINGS" ]; then
+    cat "$CLI_FINDINGS" >> "$REPORT_FILE"
+else
+    echo "No findings" >> "$REPORT_FILE"
+fi
+
+cat >> "$REPORT_FILE" << EOF
+\`\`\`
+
+### Discovery - Priority: MEDIUM
+
+\`\`\`
+EOF
+
+if [ -s "$DISCOVERY_FINDINGS" ]; then
+    cat "$DISCOVERY_FINDINGS" >> "$REPORT_FILE"
+else
+    echo "No findings" >> "$REPORT_FILE"
+fi
+
+cat >> "$REPORT_FILE" << EOF
+\`\`\`
+
+### Engine - Priority: MEDIUM
+
+\`\`\`
+EOF
+
+if [ -s "$ENGINE_FINDINGS" ]; then
+    cat "$ENGINE_FINDINGS" >> "$REPORT_FILE"
+else
+    echo "No findings" >> "$REPORT_FILE"
+fi
+
+cat >> "$REPORT_FILE" << EOF
+\`\`\`
+
+## Next Steps
+
+1. Review HIGH priority (CLI) findings first
+2. Implement or remove TODOs as appropriate
+3. Add tests for any new functionality
+4. Re-run audit to verify cleanup
+EOF
+
+echo -e "${BLUE}💾 Full report saved to: ${REPORT_FILE}${NC}"
+
+# Cleanup
+rm -f "$CLI_FINDINGS" "$DISCOVERY_FINDINGS" "$ENGINE_FINDINGS"
+
+exit 0

package/scripts/install-git-hooks.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+readonly ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+# npm runs `prepare` when installing from a GitHub URL, but its temporary
+# checkout does not include the .git directory. Hooks are only needed in a
+# developer checkout, so leave package installation untouched.
+if ! git -C "${ROOT_DIR}" rev-parse --git-dir >/dev/null 2>&1; then
+  exit 0
+fi
+
+git -C "${ROOT_DIR}" config core.hooksPath .githooks

package/scripts/release-binaries.sh

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+readonly ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+readonly RELEASE_REPOSITORY="tdk-landscape/tdk-cli-releases"
+readonly VERSION="$(node -p "require('${ROOT_DIR}/cli/package.json').version")"
+readonly RELEASE_TAG="v${VERSION}"
+readonly RELEASE_DIR="${ROOT_DIR}/release-dist-${RELEASE_TAG#v}"
+readonly PUBLISH="${1:-}"
+
+if ! command -v bun >/dev/null 2>&1; then
+  echo "bun is required to build release binaries" >&2
+  exit 1
+fi
+
+rm -rf "${RELEASE_DIR}"
+mkdir -p "${RELEASE_DIR}"
+
+build_target() {
+  local target="$1"
+  local output="$2"
+
+  bun build --compile --target="${target}" --outfile="${RELEASE_DIR}/${output}" "${ROOT_DIR}/cli/src/cli.ts"
+}
+
+build_target bun-linux-x64 tdk-linux-amd64
+build_target bun-linux-arm64 tdk-linux-arm64
+build_target bun-darwin-x64 tdk-darwin-amd64
+build_target bun-darwin-arm64 tdk-darwin-arm64
+
+# A compiled binary has no import.meta.dirname to walk up from, so it can't
+# find engine/ the way a source checkout can. template-engine.ts checks
+# exeDir/tdk-cli as a candidate - bundle the free engine (and the Handlebars
+# templates loadTemplate() reads at module init) there so a standalone binary
+# works the same as `tdk-cli-core` cloned from source.
+mkdir -p "${RELEASE_DIR}/tdk-cli"
+cp "${ROOT_DIR}/Tiltfile" "${RELEASE_DIR}/tdk-cli/Tiltfile"
+cp -R "${ROOT_DIR}/engine" "${RELEASE_DIR}/tdk-cli/engine"
+cp -R "${ROOT_DIR}/discovery" "${RELEASE_DIR}/tdk-cli/discovery"
+cp -R "${ROOT_DIR}/specs" "${RELEASE_DIR}/tdk-cli/specs"
+cp -R "${ROOT_DIR}/ext" "${RELEASE_DIR}/tdk-cli/ext"
+mkdir -p "${RELEASE_DIR}/tdk-cli/cli"
+cp -R "${ROOT_DIR}/cli/templates" "${RELEASE_DIR}/tdk-cli/cli/templates"
+
+(
+  cd "${RELEASE_DIR}"
+  shasum -a 256 tdk-linux-amd64 tdk-linux-arm64 tdk-darwin-amd64 tdk-darwin-arm64 > checksums.txt
+  zip -qr "tdk-cli-${RELEASE_TAG}-binaries.zip" \
+    tdk-linux-amd64 tdk-linux-arm64 tdk-darwin-amd64 tdk-darwin-arm64 \
+    tdk-cli checksums.txt
+  # Fixed filename (no version/tag in the name) so install.sh can always
+  # find it via the stable /releases/latest/download/ URL, unlike the zip
+  # above whose name embeds the tag and changes every release.
+  tar -czf tdk-cli-engine.tar.gz tdk-cli
+)
+
+echo "Built release assets in ${RELEASE_DIR}"
+
+if [[ "${PUBLISH}" != "--publish" ]]; then
+  exit 0
+fi
+
+if ! command -v gh >/dev/null 2>&1; then
+  echo "gh is required to publish release binaries" >&2
+  exit 1
+fi
+
+# Upload actual files only - tdk-cli/ is a directory (the bundled engine),
+# already packed inside the zip, and `gh release upload` can't take a
+# directory as an asset.
+readonly ASSETS=(
+  "${RELEASE_DIR}/tdk-linux-amd64"
+  "${RELEASE_DIR}/tdk-linux-arm64"
+  "${RELEASE_DIR}/tdk-darwin-amd64"
+  "${RELEASE_DIR}/tdk-darwin-arm64"
+  "${RELEASE_DIR}/checksums.txt"
+  "${RELEASE_DIR}/tdk-cli-${RELEASE_TAG}-binaries.zip"
+  "${RELEASE_DIR}/tdk-cli-engine.tar.gz"
+)
+
+# Never mark a release latest until every asset is uploaded. `gh release create
+# --latest FILE...` publishes the tag first, then uploads binaries, so
+# /releases/latest/download/tdk-* 404s for a few minutes (install.sh hits this).
+if gh release view "${RELEASE_TAG}" --repo "${RELEASE_REPOSITORY}" >/dev/null 2>&1; then
+  gh release upload "${RELEASE_TAG}" --repo "${RELEASE_REPOSITORY}" --clobber "${ASSETS[@]}"
+else
+  gh release create "${RELEASE_TAG}" \
+    --repo "${RELEASE_REPOSITORY}" \
+    --title "TDK CLI ${RELEASE_TAG#v}" \
+    --draft \
+    "${ASSETS[@]}"
+fi
+gh release edit "${RELEASE_TAG}" --repo "${RELEASE_REPOSITORY}" --draft=false --latest

package/scripts/setup-pre-commit.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+# Setup script for TDK CLI development environment
+
+set -e
+
+echo "🚀 Setting up TDK CLI development environment..."
+
+# Check if pre-commit is installed
+if ! command -v pre-commit &> /dev/null; then
+    echo "📦 Installing pre-commit..."
+    pip install pre-commit
+fi
+
+# Install hooks
+echo "🔧 Installing pre-commit hooks..."
+pre-commit install
+
+# Run fast tests to verify everything works
+echo "🧪 Running fast tests to verify setup..."
+if python3 -m pytest -m fast --no-cov -q 2>/dev/null; then
+    echo "✅ Fast tests passed!"
+else
+    echo "⚠️  Some tests may need dependencies, but pre-commit is installed."
+fi
+
+echo ""
+echo "✅ Setup complete! Pre-commit hooks are now installed."
+echo ""
+echo "Usage:"
+echo "  git commit        # Runs fast tests automatically"
+echo "  make test-fast    # Run fast tests manually"
+echo "  make test-generator # Run generator-specific tests"
+echo "  pre-commit run --all-files  # Run all hooks manually"

package/scripts/stage-npm-engine.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# Stages the free TDK Tilt extension (Tiltfile, engine/, discovery/, specs/,
+# ext/) into cli/ before `npm publish`.
+#
+# npm's `files` field can only package files inside the package directory
+# (cli/), but those directories live at the repo root - the same directories
+# scripts/release-binaries.sh bundles as tdk-cli/ next to the compiled
+# binaries. Staging them here lets findSelfContainedEngineRoot() in
+# template-engine.ts (vendorTdkExtension) find them for an npm/bun-installed
+# package the same way it already does for a plain git clone: Tiltfile and
+# engine/ sitting next to each other.
+#
+# Cleaned up by --clean (also gitignored, so a forgotten copy never lands in
+# a commit).
+set -euo pipefail
+
+readonly ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+readonly CLI_DIR="${ROOT_DIR}/cli"
+readonly DIRS=(engine discovery specs ext)
+
+if [[ "${1:-}" == "--clean" ]]; then
+  rm -f "${CLI_DIR}/Tiltfile"
+  for d in "${DIRS[@]}"; do
+    rm -rf "${CLI_DIR}/${d}"
+  done
+  echo "Cleaned staged engine files from cli/"
+  exit 0
+fi
+
+cp "${ROOT_DIR}/Tiltfile" "${CLI_DIR}/Tiltfile"
+for d in "${DIRS[@]}"; do
+  rm -rf "${CLI_DIR}/${d}"
+  cp -R "${ROOT_DIR}/${d}" "${CLI_DIR}/${d}"
+done
+
+echo "Staged Tiltfile, ${DIRS[*]} into cli/ for npm publish"

package/shared-platform-engineering/docker-templates/bun-hoisted-symlink-fix.sh

@@ -0,0 +1,23 @@
+#!/bin/sh
+set -e
+
+# Fix Bun hoisted package symlinks that can break when copied across Docker stages.
+for pkg in node_modules/.bun/*/node_modules/*; do
+  [ -d "$pkg" ] || continue
+  name=$(basename "$pkg")
+  case "$name" in
+    @*) continue ;;
+  esac
+  ln -sfn "$(pwd)/$pkg" "node_modules/$name"
+done
+
+for pkg in node_modules/.bun/*/node_modules/@*/*; do
+  [ -d "$pkg" ] || continue
+  scope=$(basename "$(dirname "$pkg")")
+  name=$(basename "$pkg")
+  if [ "$scope" = "@prisma" ] && [ "$name" = "engines" ]; then
+    continue
+  fi
+  mkdir -p "node_modules/$scope"
+  ln -sfn "$(pwd)/$pkg" "node_modules/$scope/$name"
+done