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

package/cli/src/index.ts

@@ -0,0 +1,86 @@
+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

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

package/cli/src/types/index.ts

@@ -0,0 +1,351 @@
+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;
+  };
+}
+
+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

@@ -0,0 +1,98 @@
+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

@@ -0,0 +1,170 @@
+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));
+  });
+});