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

package/cli/src/index.ts

@@ -1,86 +0,0 @@
-export type {
-  AutogeneratedFile,
-  BaseTooltipProps,
-  CheckResult,
-  CreatableResourceType,
-  DetailPanelProps,
-  DiscoveredResource,
-  DiscoveredStack,
-  DiscoveryContext,
-  ErrorScreenProps,
-  FileGenerationTask,
-  FileNode,
-  FileTreeProps,
-  FileType,
-  HelpPanelProps,
-  JsonArray,
-  JsonObject,
-  JsonValue,
-  LoadingScreenProps,
-  ProjectConfig,
-  ProjectDiscovery,
-  ProjectOptionalInfra,
-  ProjectPhaseDefinition,
-  ResourceConfig,
-  ResourceFileType,
-  ResourceMetadata,
-  ResourceSelectInputProps,
-  ResourceStatus,
-  ResourceTableProps,
-  ResourceType,
-  SelectItem,
-  ServiceUrl,
-  StackHealthStatus,
-  StackMetadata,
-  StatusCategory,
-  StatusValue,
-  Tab,
-  TabBarProps,
-  TabId,
-  TiltBuildStatus,
-  TiltCommandResult,
-  TiltResourceStatus,
-  TiltRuntimeStatus,
-  TooltipProps,
-  ValidationResult,
-} from "./types/index.js";
-
-export {
-  CREATABLE_RESOURCE_TYPES,
-  isCreatableResourceType,
-} from "./types/index.js";
-export {
-  Cache,
-  createCacheValidator,
-} from "./utils/cache.js";
-export {
-  assertValid,
-  confirmAction,
-  confirmOrCancel,
-  handleDryRun,
-} from "./utils/command-helpers.js";
-// Re-export discovery-context functions for resources-by-stack operations
-export { createDiscoveryContext } from "./utils/discovery-context.js";
-export { writeFilesWithProgress } from "./utils/file-helpers.js";
-export { findProjectRoot } from "./utils/paths.js";
-export {
-  checkPortStatus,
-  findAvailablePort,
-} from "./utils/port-assignment.js";
-export {
-  clearMetadataCache,
-  discoverResources,
-  discoverStacks,
-  getAllStacks,
-  getResourceMetadata,
-  getResourcesForStack,
-  getStackMetadata,
-  stackExists,
-} from "./utils/services.js";
-export {
-  buildTiltDownArgs,
-  buildTiltUpArgs,
-  getTiltfilePath,
-  isTiltAvailable,
-  runTilt,
-} from "./utils/tilt.js";

package/cli/src/templates.d.ts

@@ -1,4 +0,0 @@
-declare module "*.hbs" {
-  const content: string;
-  export default content;
-}

package/cli/src/types/index.ts

@@ -1,353 +0,0 @@
-export interface DiscoveredResource {
-  name: string;
-  path: string;
-  configPath: string;
-  config?: ResourceConfig;
-  stack?: string;
-  port?: number;
-  type?: ResourceType;
-}
-
-export interface ResourceConfig {
-  appName: string;
-  appType: "backend" | "frontend" | "library" | "sdk" | "worker" | "migrator";
-  stack?: string;
-  port?: number;
-  replicas?: number;
-  runtime?: string;
-  featuresEnabled?: string[];
-  dependsOn?: string[];
-  enabled?: boolean;
-  basePath?: string;
-  backendName?: string;
-  apiPath?: string;
-  /** On-demand scaling via Sablier (Premium - requires TDK_LICENSE_KEY). See hasSablierLicense() in extension-fetch.ts. */
-  sablier?: {
-    enable?: boolean;
-    group?: string;
-    sessionDuration?: string;
-    /** Skip this resource during `tdk up` entirely; a Traefik static route wakes it on first request. Requires enable: true. */
-    deferStart?: boolean;
-  };
-}
-
-export interface DiscoveredStack {
-  name: string;
-  description?: string;
-  resources: DiscoveredResource[];
-  resourceCount: number;
-}
-
-export interface TiltCommandResult {
-  exitCode: number;
-  stdout: string;
-  stderr: string;
-}
-
-export type FileType = "docker" | "tilt" | "config" | "prisma" | "generated" | "unknown";
-
-export interface AutogeneratedFile {
-  name: string;
-  path: string;
-  type: FileType;
-  size: number;
-  lastModified: string;
-}
-
-export type ResourceFileType = "json" | "text";
-
-export interface FileGenerationTask {
-  type: ResourceFileType;
-  filename: string;
-  content: JsonValue;
-  description: string;
-  emoji: string;
-}
-
-export type ResourceType = "frontend" | "backend" | "library" | "sdk" | "worker" | "migrator";
-
-export const CREATABLE_RESOURCE_TYPES = ["backend", "frontend", "worker"] as const;
-
-export type CreatableResourceType = Extract<
-  ResourceType,
-  (typeof CREATABLE_RESOURCE_TYPES)[number]
->;
-
-export function isCreatableResourceType(value: unknown): value is CreatableResourceType {
-  return (
-    typeof value === "string" && (CREATABLE_RESOURCE_TYPES as readonly string[]).includes(value)
-  );
-}
-
-export type ResourceStatus = "ready" | "pending" | "error" | "unknown";
-
-export interface ResourceMetadata {
-  name: string;
-  stack?: string;
-  type: ResourceType;
-  port?: number;
-  createdAt: string;
-  lastModified: string;
-  dependencies: string[];
-  hasDockerfile: boolean;
-  hasTiltfile: boolean;
-  hasDockerCompose: boolean;
-  autogeneratedFiles: AutogeneratedFile[];
-  status: ResourceStatus;
-}
-
-export type StackHealthStatus = "healthy" | "degraded" | "error" | "unknown";
-
-export interface StackMetadata {
-  name: string;
-  resourceCount: number;
-  createdAt: string;
-  lastModified: string;
-  resources: ResourceMetadata[];
-  overallStatus: StackHealthStatus;
-}
-
-export type TiltRuntimeStatus = "running" | "pending" | "error" | "unknown";
-
-export type TiltBuildStatus = "ok" | "error" | "in_progress" | "unknown";
-
-export interface TiltResourceStatus {
-  runtimeStatus: TiltRuntimeStatus;
-  buildStatus: TiltBuildStatus;
-  lastBuildTime: string | null;
-  currentBuildTime: string | null;
-  available: boolean;
-}
-
-export type JsonValue = string | number | boolean | null | JsonArray | JsonObject;
-
-export interface JsonArray extends Array<JsonValue> {}
-export interface JsonObject extends Record<string, JsonValue> {}
-
-export interface ProjectPhaseDefinition {
-  name: string;
-  description: string;
-  enabledStacks: string[];
-}
-
-export interface LegacyProjectStackDefinition {
-  name: string;
-  description: string;
-  services: string[];
-}
-
-export interface ProjectOptionalInfra {
-  monitoring: boolean;
-  elk: boolean;
-  debezium: boolean;
-  golden_image: boolean;
-  verdaccio: boolean;
-}
-
-export interface ProjectDiscovery {
-  paths: string[];
-}
-
-export interface ProjectConfig {
-  version: string;
-  project: {
-    name: string;
-    version: string;
-  };
-  phases: {
-    pre_alpha: ProjectPhaseDefinition;
-    alpha: ProjectPhaseDefinition;
-    beta: ProjectPhaseDefinition;
-    out_of_scope: ProjectPhaseDefinition;
-  };
-  stacks?: {
-    pre_alpha: LegacyProjectStackDefinition;
-    alpha: LegacyProjectStackDefinition;
-    beta: LegacyProjectStackDefinition;
-    out_of_scope: LegacyProjectStackDefinition;
-  };
-  always_enabled_infra?: string[];
-  optional_infra: ProjectOptionalInfra;
-  discovery: ProjectDiscovery;
-  overrides?: Record<string, JsonValue>;
-}
-
-export type TabId = "overview" | "resources" | "events" | "files" | "config";
-
-export interface Tab {
-  id: TabId;
-  label: string;
-  shortcut: string;
-}
-
-export interface TabBarProps {
-  activeTab: TabId;
-  onTabChange: (tab: TabId) => void;
-  compact?: boolean;
-}
-
-// Reuse BaseTooltipProps instead of duplicating
-export type TooltipProps = BaseTooltipProps;
-
-export interface DetailPanelProps {
-  stack: DiscoveredStack | null;
-  service: DiscoveredResource | null;
-  stackMetadata?: StackMetadata | null;
-  visible: boolean;
-}
-
-export interface ResourceTableProps {
-  resources: ResourceMetadata[];
-  maxWidth?: number;
-}
-
-export interface ResourceSelectInputProps {
-  items: SelectItem[];
-  onSelect: (item: SelectItem) => void;
-  highlightedIndex: number;
-}
-
-export interface FileNode {
-  name: string;
-  path: string;
-  type: "directory" | "file";
-  fileType?: FileType;
-  children?: FileNode[];
-  size?: number;
-  lastModified?: string;
-}
-
-export interface ValidationResult {
-  valid: boolean;
-  error?: string;
-}
-
-export interface CheckResult {
-  name: string;
-  didPass: boolean;
-  message: string;
-  fix?: string;
-  /** Check could not run meaningfully (e.g. nothing started yet); not a failure. */
-  isSkipped?: boolean;
-}
-
-export interface ServiceUrl {
-  name: string;
-  stack?: string;
-  basePath: string;
-  url: string;
-  port?: number;
-  status: "running" | "stopped" | "unknown";
-}
-
-export interface SelectItem {
-  label: string;
-  value: string;
-}
-
-export type StatusValue =
-  | ResourceStatus
-  | StackHealthStatus
-  | TiltRuntimeStatus
-  | ServiceUrl["status"]
-  | "active"
-  | "failed"
-  | "critical"
-  | "stopped"
-  | "starting"
-  | "building"
-  | undefined;
-
-export type StatusCategory = "success" | "error" | "warning" | "unknown";
-
-export interface DiscoveryContext {
-  resources: DiscoveredResource[];
-  stacks: DiscoveredStack[];
-  stackNames: string[];
-  unassignedResources: DiscoveredResource[];
-  resourcesByStack: Map<string, DiscoveredResource[]>;
-}
-
-export interface FileTreeProps {
-  nodes: FileNode[];
-  onSelect?: (node: FileNode) => void;
-  selectedPath?: string;
-}
-
-export interface BaseTooltipProps {
-  content: string;
-  shortcut?: string;
-  visible: boolean;
-  maxWidth?: number;
-  wrapText?: boolean;
-  prefix?: string;
-  marginTop?: number;
-}
-
-export interface LoadingScreenProps {
-  progress: number;
-  message: string;
-}
-
-export interface ErrorScreenProps {
-  error: string;
-  onRetry: () => void;
-}
-
-export interface HelpPanelProps {
-  onClose: () => void;
-}
-
-// ============================================================================
-// Cache Types (consolidated from utils/cache.ts)
-// ============================================================================
-
-export interface CacheEntry<T> {
-  value: T;
-  timestamp: number;
-}
-
-export interface CacheOptions {
-  ttlMs: number;
-}
-
-// ============================================================================
-// Package Types (consolidated from utils/paths.ts)
-// ============================================================================
-
-export interface PackageInfo {
-  name: string;
-  version: string;
-  fullPackage: JsonObject;
-}
-
-// ============================================================================
-// Port Assignment Types (consolidated from utils/port-assignment.ts)
-// ============================================================================
-
-export type PortAssignableResourceType = Extract<
-  CreatableResourceType,
-  "backend" | "frontend" | "worker" | "migrator"
->;
-
-// ============================================================================
-// Config Types (consolidated from commands/config.ts)
-// ============================================================================
-
-export type MasterConfigFileName =
-  | "TILT_TECH_STACK.star"
-  | "TILT_RESOURCE_DEFAULTS.star"
-  | "spec.master";
-
-/**
- * Type guard to validate filename is a known master config file.
- * Eliminates the need for 'as MasterConfigFileName' assertion.
- */
-export function isMasterConfigFileName(filename: string): filename is MasterConfigFileName {
-  const validNames: readonly string[] = [
-    "TILT_TECH_STACK.star",
-    "TILT_RESOURCE_DEFAULTS.star",
-    "spec.master",
-  ];
-  return validNames.includes(filename);
-}

package/cli/src/utils/__tests__/cache.test.ts

@@ -1,98 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { Cache, createCacheValidator } from "../cache.js";
-
-describe("Cache", () => {
-  it("should store and retrieve values", () => {
-    const cache = new Cache<string>({ ttlMs: 5000 });
-    cache.set("key1", "value1");
-    expect(cache.get("key1")).toBe("value1");
-  });
-
-  it("should return undefined for missing keys", () => {
-    const cache = new Cache<string>({ ttlMs: 5000 });
-    expect(cache.get("nonexistent")).toBeUndefined();
-  });
-
-  it("should report has() correctly", () => {
-    const cache = new Cache<string>({ ttlMs: 5000 });
-    cache.set("key1", "value1");
-    expect(cache.has("key1")).toBe(true);
-    expect(cache.has("nonexistent")).toBe(false);
-  });
-
-  it("should delete values", () => {
-    const cache = new Cache<string>({ ttlMs: 5000 });
-    cache.set("key1", "value1");
-    cache.delete("key1");
-    expect(cache.get("key1")).toBeUndefined();
-  });
-
-  it("should clear all values", () => {
-    const cache = new Cache<string>({ ttlMs: 5000 });
-    cache.set("key1", "value1");
-    cache.set("key2", "value2");
-    cache.clear();
-    expect(cache.size()).toBe(0);
-  });
-
-  it("should expire entries after TTL", async () => {
-    const cache = new Cache<string>({ ttlMs: 10 });
-    cache.set("key1", "value1");
-    expect(cache.has("key1")).toBe(true);
-    await new Promise((resolve) => setTimeout(resolve, 20));
-    expect(cache.has("key1")).toBe(false);
-    expect(cache.get("key1")).toBeUndefined();
-  });
-
-  it("should return correct size", () => {
-    const cache = new Cache<string>({ ttlMs: 5000 });
-    expect(cache.size()).toBe(0);
-    cache.set("a", "1");
-    expect(cache.size()).toBe(1);
-    cache.set("b", "2");
-    expect(cache.size()).toBe(2);
-  });
-
-  it("should return all valid keys", () => {
-    const cache = new Cache<string>({ ttlMs: 5000 });
-    cache.set("a", "1");
-    cache.set("b", "2");
-    cache.set("c", "3");
-    expect(cache.keys().sort()).toEqual(["a", "b", "c"]);
-  });
-
-  it("should not include expired keys in keys()", async () => {
-    const cache = new Cache<string>({ ttlMs: 10 });
-    cache.set("a", "1");
-    cache.set("b", "2");
-    await new Promise((resolve) => setTimeout(resolve, 20));
-    expect(cache.keys()).toEqual([]);
-  });
-});
-
-describe("createCacheValidator", () => {
-  it("should start as invalid", () => {
-    const validator = createCacheValidator(1000);
-    expect(validator.isValid()).toBe(false);
-  });
-
-  it("should be valid after markUpdated", () => {
-    const validator = createCacheValidator(1000);
-    validator.markUpdated();
-    expect(validator.isValid()).toBe(true);
-  });
-
-  it("should expire after TTL", async () => {
-    const validator = createCacheValidator(10);
-    validator.markUpdated();
-    await new Promise((resolve) => setTimeout(resolve, 20));
-    expect(validator.isValid()).toBe(false);
-  });
-
-  it("should reset to invalid", () => {
-    const validator = createCacheValidator(1000);
-    validator.markUpdated();
-    validator.reset();
-    expect(validator.isValid()).toBe(false);
-  });
-});

package/cli/src/utils/__tests__/formatting.test.ts

@@ -1,170 +0,0 @@
-import { describe, expect, it } from "vitest";
-import {
-  formatBoxLine,
-  formatBytes,
-  formatCentered,
-  formatCount,
-  formatDate,
-  formatPadded,
-  formatShortDate,
-  getStatusColor,
-  getStatusIcon,
-  truncate,
-} from "../formatting.js";
-
-describe("formatCount", () => {
-  it("should format singular", () => {
-    expect(formatCount(1, "resource")).toBe("1 resource");
-  });
-
-  it("should format plural with default suffix", () => {
-    expect(formatCount(3, "resource")).toBe("3 resources");
-  });
-
-  it("should format plural with custom plural", () => {
-    expect(formatCount(2, "index", "indices")).toBe("2 indices");
-  });
-
-  it("should handle zero as plural", () => {
-    expect(formatCount(0, "service")).toBe("0 services");
-  });
-});
-
-describe("formatDate", () => {
-  it("should return a string", () => {
-    const result = formatDate(new Date().toISOString());
-    expect(typeof result).toBe("string");
-    expect(result.length).toBeGreaterThan(0);
-  });
-
-  it("should handle ISO date strings", () => {
-    const date = new Date("2024-01-15T10:30:00Z");
-    expect(formatDate(date.toISOString())).toBeTruthy();
-  });
-});
-
-describe("formatShortDate", () => {
-  it("should return a short date string", () => {
-    const result = formatShortDate(new Date().toISOString());
-    expect(typeof result).toBe("string");
-    expect(result.length).toBeGreaterThan(0);
-  });
-});
-
-describe("getStatusColor", () => {
-  it("should return green for ready status", () => {
-    expect(getStatusColor("ready")).toBe("green");
-  });
-
-  it("should return green for healthy status", () => {
-    expect(getStatusColor("healthy")).toBe("green");
-  });
-
-  it("should return red for error status", () => {
-    expect(getStatusColor("error")).toBe("red");
-  });
-
-  it("should return yellow for pending status", () => {
-    expect(getStatusColor("pending")).toBe("yellow");
-  });
-
-  it("should return gray for unknown status", () => {
-    expect(getStatusColor("unknown")).toBe("gray");
-  });
-
-  it("should handle undefined status", () => {
-    expect(getStatusColor(undefined)).toBe("gray");
-  });
-});
-
-describe("getStatusIcon", () => {
-  it("should return ✓ for ready", () => {
-    expect(getStatusIcon("ready")).toBe("✓");
-  });
-
-  it("should return ✗ for error", () => {
-    expect(getStatusIcon("error")).toBe("✗");
-  });
-
-  it("should return ? for unknown", () => {
-    expect(getStatusIcon("unknown")).toBe("?");
-  });
-});
-
-describe("truncate", () => {
-  it("should not truncate short strings", () => {
-    expect(truncate("hello", 10)).toBe("hello");
-  });
-
-  it("should truncate long strings with ellipsis", () => {
-    const result = truncate("hello world this is long", 10);
-    expect(result).toBe("hello w...");
-    expect(result.length).toBe(10);
-  });
-
-  it("should handle empty string", () => {
-    expect(truncate("", 5)).toBe("");
-  });
-
-  it("should handle exactly max length", () => {
-    expect(truncate("hello", 5)).toBe("hello");
-  });
-});
-
-describe("formatBytes", () => {
-  it("should format bytes", () => {
-    expect(formatBytes(500)).toBe("500 B");
-  });
-
-  it("should format kilobytes", () => {
-    expect(formatBytes(2048)).toBe("2.0 KB");
-  });
-
-  it("should format megabytes", () => {
-    expect(formatBytes(1048576)).toBe("1.0 MB");
-  });
-
-  it("should handle zero", () => {
-    expect(formatBytes(0)).toBe("0 B");
-  });
-});
-
-describe("formatCentered", () => {
-  it("should center text within width", () => {
-    const result = formatCentered("hi", 10);
-    expect(result.length).toBe(10);
-    expect(result).toContain("hi");
-  });
-
-  it("should handle text longer than width (returns as-is, no truncation)", () => {
-    const result = formatCentered("hello world", 5);
-    expect(result).toBe("hello world");
-  });
-});
-
-describe("formatPadded", () => {
-  it("should pad short text to width", () => {
-    const result = formatPadded("hi", 10);
-    expect(result.length).toBe(10);
-    expect(result).toMatch(/^hi\s+$/);
-  });
-
-  it("should truncate long text with ellipsis", () => {
-    const result = formatPadded("hello world", 6);
-    expect(result).toBe("hello…");
-    expect(result.length).toBe(6);
-  });
-});
-
-describe("formatBoxLine", () => {
-  it("should return default width line", () => {
-    const result = formatBoxLine();
-    expect(result.length).toBe(62);
-    expect(result).toBe("─".repeat(62));
-  });
-
-  it("should accept custom char and width", () => {
-    const result = formatBoxLine("=", 10);
-    expect(result).toBe("=".repeat(10));
-  });
-});