@tdk-landscape/tdk-cli-core 1.3.14

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAGnE,MAAM,UAAU,eAAe,CAAC,QAAQ,GAAW,GAAG,EAAE;IACtD,IAAI,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1B,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YACzD,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM;QACR,CAAC;QACD,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,IAAI,YAAY,GAAuB,IAAI,CAAC;AAE5C,SAAS,cAAc;IACrB,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,mFAAmF;IACnF,MAAM,MAAM,GAAY,WAAW,CAAC;IAEpC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,WAAW,GAAG,MAAoB,CAAC;IAEzC,YAAY,GAAG;QACb,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,UAAU,CAAC;QAC5C,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;QAC/C,WAAW,EAAE,WAAW;KACzB,CAAC;IAEF,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,cAAc,EAAE,CAAC,OAAO,CAAC;AAClC,CAAC"}

package/dist/utils/port-assignment.d.ts

@@ -0,0 +1,6 @@
+import type { DiscoveredResource, PortAssignableResourceType } from "../types/index.js";
+export declare function checkPortStatus(port: number): Promise<"running" | "stopped" | "unknown">;
+export declare function findAvailablePort(basePort: number, maxAttempts?: number): Promise<number | null>;
+export declare function getUsedPorts(resources: DiscoveredResource[]): Set<number>;
+export declare function assignPort(resourceType: PortAssignableResourceType, existingResources: DiscoveredResource[]): number;
+//# sourceMappingURL=port-assignment.d.ts.map

package/dist/utils/port-assignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-assignment.d.ts","sourceRoot":"","sources":["../../src/utils/port-assignment.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAgBxF,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC,CA0B9F;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAW,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAQzE;AAcD,wBAAgB,UAAU,CACxB,YAAY,EAAE,0BAA0B,EACxC,iBAAiB,EAAE,kBAAkB,EAAE,GACtC,MAAM,CAcR"}

package/dist/utils/port-assignment.js

@@ -0,0 +1,75 @@
+import { spawn } from "node:child_process";
+import { createConnection } from "node:net";
+import { PORT_RANGES } from "./constants.js";
+function isPortAvailable(port) {
+    return new Promise((resolve) => {
+        const server = createConnection({ port, host: "127.0.0.1" }, () => {
+            server.destroy();
+            resolve(false);
+        });
+        server.on("error", () => {
+            resolve(true);
+        });
+    });
+}
+export async function checkPortStatus(port) {
+    return new Promise((resolve) => {
+        const child = spawn("lsof", ["-Pi", `:${port}`, "-sTCP:LISTEN"], {
+            timeout: 3000,
+            stdio: "pipe",
+        });
+        let hasOutput = false;
+        child.stdout?.on("data", () => {
+            hasOutput = true;
+        });
+        child.on("close", (code) => {
+            // lsof returns 0 if it found something, 1 if nothing found
+            if (code === 0) {
+                resolve("running");
+            }
+            else {
+                resolve(hasOutput ? "running" : "stopped");
+            }
+        });
+        child.on("error", () => {
+            resolve("unknown");
+        });
+    });
+}
+export async function findAvailablePort(basePort, maxAttempts = 10) {
+    for (let i = 0; i < maxAttempts; i++) {
+        const port = basePort + i;
+        if (await isPortAvailable(port)) {
+            return port;
+        }
+    }
+    return null;
+}
+export function getUsedPorts(resources) {
+    const usedPorts = new Set();
+    for (const r of resources) {
+        if (r.port && r.port > 0) {
+            usedPorts.add(r.port);
+        }
+    }
+    return usedPorts;
+}
+function findNextAvailablePort(usedPorts, range) {
+    for (let port = range.base; port <= range.max; port++) {
+        if (!usedPorts.has(port)) {
+            return port;
+        }
+    }
+    return null;
+}
+export function assignPort(resourceType, existingResources) {
+    const usedPorts = getUsedPorts(existingResources);
+    const portRange = PORT_RANGES[resourceType];
+    const assignedPort = findNextAvailablePort(usedPorts, portRange);
+    if (assignedPort === null) {
+        throw new Error(`No available ports in range ${portRange.base}-${portRange.max}. ` +
+            "Check TILT_RESOURCE_DEFAULTS.star for port configuration.");
+    }
+    return assignedPort;
+}
+//# sourceMappingURL=port-assignment.js.map

package/dist/utils/port-assignment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-assignment.js","sourceRoot":"","sources":["../../src/utils/port-assignment.ts"],"names":[],"mappings":"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"}

package/dist/utils/project-features.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Project-Level Features
+ *
+ * These are infrastructure and optional services enabled at the project level.
+ * They are available to all resources and are configured in project.json stacks.
+ *
+ * Default: All CORE features enabled in pre_alpha stack
+ * Optional/premium: disabled by default (can be enabled in optional_infra)
+ */
+export interface ProjectFeature {
+    name: string;
+    description: string;
+    category: "core" | "optional" | "premium";
+    phase: "pre_alpha" | "alpha" | "beta";
+    enabled_by_default: boolean;
+    dependsOn?: string[];
+}
+export declare const PROJECT_FEATURES: Record<string, ProjectFeature>;
+/**
+ * Get all enabled project features
+ */
+export declare function getEnabledProjectFeatures(optional_infra?: Record<string, boolean>): string[];
+//# sourceMappingURL=project-features.d.ts.map

package/dist/utils/project-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-features.d.ts","sourceRoot":"","sources":["../../src/utils/project-features.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1C,KAAK,EAAE,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IACtC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAyE3D,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAmB5F"}

package/dist/utils/project-features.js

@@ -0,0 +1,98 @@
+/**
+ * Project-Level Features
+ *
+ * These are infrastructure and optional services enabled at the project level.
+ * They are available to all resources and are configured in project.json stacks.
+ *
+ * Default: All CORE features enabled in pre_alpha stack
+ * Optional/premium: disabled by default (can be enabled in optional_infra)
+ */
+export const PROJECT_FEATURES = {
+    // ============================================================================
+    // CORE INFRASTRUCTURE (always enabled in pre_alpha)
+    // ============================================================================
+    proxy: {
+        name: "proxy",
+        description: "Traefik reverse proxy and API gateway for routing all services",
+        category: "core",
+        phase: "pre_alpha",
+        enabled_by_default: true,
+        dependsOn: [],
+    },
+    // Key/name must be the literal Tilt resource name (PlatformDockerConstants.VERDACCIO_RESOURCE_NAME
+    // in tdk-cli-extensions), since project.json's services list is copied verbatim into
+    // PRE_ALPHA_RESOURCES and matched against that name by should_enable(). "registry" would
+    // silently fail to enable Verdaccio.
+    verdaccio: {
+        name: "verdaccio",
+        description: "Verdaccio npm registry for package management and local publishing",
+        category: "premium",
+        phase: "pre_alpha",
+        enabled_by_default: false,
+        dependsOn: [],
+    },
+    "database-management": {
+        name: "database-management",
+        description: "PostgreSQL database for data persistence and SQL operations",
+        category: "core",
+        phase: "pre_alpha",
+        enabled_by_default: true,
+        dependsOn: [],
+    },
+    // ============================================================================
+    // OPTIONAL INFRASTRUCTURE (disabled by default, enable in optional_infra)
+    // ============================================================================
+    monitoring: {
+        name: "monitoring",
+        description: "SigNoz or SkyWalking observability platform for monitoring and tracing",
+        category: "optional",
+        phase: "pre_alpha",
+        enabled_by_default: false,
+        dependsOn: ["database-management"],
+    },
+    elk: {
+        name: "elk",
+        description: "Elasticsearch, Logstash, Kibana stack for log aggregation and analysis",
+        category: "optional",
+        phase: "pre_alpha",
+        enabled_by_default: false,
+        dependsOn: [],
+    },
+    debezium: {
+        name: "debezium",
+        description: "Change Data Capture for real-time data streaming from databases",
+        category: "optional",
+        phase: "pre_alpha",
+        enabled_by_default: false,
+        dependsOn: ["database-management"],
+    },
+    "golden-image": {
+        name: "golden-image",
+        description: "Pre-built Docker image layer for faster builds and smaller deployments",
+        category: "optional",
+        phase: "pre_alpha",
+        enabled_by_default: true,
+        dependsOn: [],
+    },
+};
+/**
+ * Get all enabled project features
+ */
+export function getEnabledProjectFeatures(optional_infra) {
+    const enabled = [];
+    for (const [key, feature] of Object.entries(PROJECT_FEATURES)) {
+        if (feature.enabled_by_default) {
+            enabled.push(key);
+        }
+    }
+    // Add optional features if enabled
+    if (optional_infra) {
+        for (const [key, isEnabled] of Object.entries(optional_infra)) {
+            if (isEnabled && PROJECT_FEATURES[key]) {
+                enabled.push(key);
+            }
+        }
+    }
+    return enabled;
+}
+//# sourceMappingURL=project-features.js.map

package/dist/utils/project-features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-features.js","sourceRoot":"","sources":["../../src/utils/project-features.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,MAAM,CAAC,MAAM,gBAAgB,GAAmC;IAC9D,+EAA+E;IAC/E,oDAAoD;IACpD,+EAA+E;IAC/E,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,gEAAgE;QAC7E,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,WAAW;QAClB,kBAAkB,EAAE,IAAI;QACxB,SAAS,EAAE,EAAE;KACd;IAED,mGAAmG;IACnG,qFAAqF;IACrF,yFAAyF;IACzF,qCAAqC;IACrC,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,oEAAoE;QACjF,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,WAAW;QAClB,kBAAkB,EAAE,KAAK;QACzB,SAAS,EAAE,EAAE;KACd;IAED,qBAAqB,EAAE;QACrB,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,6DAA6D;QAC1E,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,WAAW;QAClB,kBAAkB,EAAE,IAAI;QACxB,SAAS,EAAE,EAAE;KACd;IAED,+EAA+E;IAC/E,0EAA0E;IAC1E,+EAA+E;IAC/E,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,wEAAwE;QACrF,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,WAAW;QAClB,kBAAkB,EAAE,KAAK;QACzB,SAAS,EAAE,CAAC,qBAAqB,CAAC;KACnC;IAED,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,wEAAwE;QACrF,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,WAAW;QAClB,kBAAkB,EAAE,KAAK;QACzB,SAAS,EAAE,EAAE;KACd;IAED,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,iEAAiE;QAC9E,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,WAAW;QAClB,kBAAkB,EAAE,KAAK;QACzB,SAAS,EAAE,CAAC,qBAAqB,CAAC;KACnC;IAED,cAAc,EAAE;QACd,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,wEAAwE;QACrF,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,WAAW;QAClB,kBAAkB,EAAE,IAAI;QACxB,SAAS,EAAE,EAAE;KACd;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,cAAwC;IAChF,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC9D,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YAC9D,IAAI,SAAS,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/project-templates.d.ts

@@ -0,0 +1,7 @@
+export interface ProjectTemplate {
+    repo: string;
+    description: string;
+}
+/** Starter projects `tdk project <name>` can clone. Keep in sync with the public tdk-landscape examples. */
+export declare const PROJECT_TEMPLATES: Record<string, ProjectTemplate>;
+//# sourceMappingURL=project-templates.d.ts.map

package/dist/utils/project-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-templates.d.ts","sourceRoot":"","sources":["../../src/utils/project-templates.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4GAA4G;AAC5G,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAqB7D,CAAC"}

package/dist/utils/project-templates.js

@@ -0,0 +1,24 @@
+/** Starter projects `tdk project <name>` can clone. Keep in sync with the public tdk-landscape examples. */
+export const PROJECT_TEMPLATES = {
+    restaurant: {
+        repo: "https://github.com/tdk-landscape/tdk-restaurant-example.git",
+        description: "Restaurant ops: reservations, kitchen, floor control (Hono + Vite + Bun)",
+    },
+    saas: {
+        repo: "https://github.com/tdk-landscape/tdk-saas-starter.git",
+        description: "SaaS starter: account dashboard and a working checkout button (Hono + Vite + Bun)",
+    },
+    erp: {
+        repo: "https://github.com/tdk-landscape/tdk-erp-system.git",
+        description: "Enterprise ERP: 100 microservices across 7 business domains",
+    },
+    "user-management": {
+        repo: "https://github.com/tdk-landscape/tdk-user-management.git",
+        description: "User/auth management services",
+    },
+    example: {
+        repo: "https://github.com/tdk-landscape/tdk-example.git",
+        description: "Minimal Project-Stack-Resource (PSR) demonstration",
+    },
+};
+//# sourceMappingURL=project-templates.js.map

package/dist/utils/project-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-templates.js","sourceRoot":"","sources":["../../src/utils/project-templates.ts"],"names":[],"mappings":"AAKA,4GAA4G;AAC5G,MAAM,CAAC,MAAM,iBAAiB,GAAoC;IAChE,UAAU,EAAE;QACV,IAAI,EAAE,6DAA6D;QACnE,WAAW,EAAE,0EAA0E;KACxF;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,uDAAuD;QAC7D,WAAW,EAAE,mFAAmF;KACjG;IACD,GAAG,EAAE;QACH,IAAI,EAAE,qDAAqD;QAC3D,WAAW,EAAE,6DAA6D;KAC3E;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,0DAA0D;QAChE,WAAW,EAAE,+BAA+B;KAC7C;IACD,OAAO,EAAE;QACP,IAAI,EAAE,kDAAkD;QACxD,WAAW,EAAE,oDAAoD;KAClE;CACF,CAAC"}

package/dist/utils/resource-features.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Resource-Level Features
+ *
+ * These are code generators and configurations that run per-service/resource.
+ * They are controlled via the features: [] array in each service.json file.
+ *
+ * Frontend services: api-client, env-config, api-index (enabled by default)
+ * Backend services: prisma (enabled by default)
+ */
+export type ResourceType = "frontend" | "backend" | "worker" | "migrator" | "sdk";
+export interface ResourceFeature {
+    name: string;
+    description: string;
+    applies_to: ResourceType[];
+    enabled_by_default: boolean;
+    generator_file: string;
+    output_file: string;
+}
+export declare const RESOURCE_FEATURES: Record<string, ResourceFeature>;
+/**
+ * Get default features for a resource type
+ */
+export declare function getDefaultFeaturesForResourceType(appType: ResourceType): string[];
+/**
+ * Get all generators for a resource type (for documentation)
+ */
+export declare function getGeneratorsForResourceType(appType: ResourceType): ResourceFeature[];
+//# sourceMappingURL=resource-features.d.ts.map

package/dist/utils/resource-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-features.d.ts","sourceRoot":"","sources":["../../src/utils/resource-features.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAiI7D,CAAC;AAEF;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAejF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,YAAY,GAAG,eAAe,EAAE,CAErF"}

package/dist/utils/resource-features.js

@@ -0,0 +1,148 @@
+/**
+ * Resource-Level Features
+ *
+ * These are code generators and configurations that run per-service/resource.
+ * They are controlled via the features: [] array in each service.json file.
+ *
+ * Frontend services: api-client, env-config, api-index (enabled by default)
+ * Backend services: prisma (enabled by default)
+ */
+export const RESOURCE_FEATURES = {
+    // ============================================================================
+    // FRONTEND GENERATORS
+    // ============================================================================
+    "api-client": {
+        name: "api-client",
+        description: "Pre-configured API client for backend communication (createApiClient wrapper)",
+        applies_to: ["frontend"],
+        enabled_by_default: true,
+        generator_file: "engine/topologies/tilt/resources/orchestrator/generators/frontend.star",
+        output_file: ".autogenerated/api-client.ts",
+    },
+    "env-config": {
+        name: "env-config",
+        description: "Environment constants and configuration (Vite env vars)",
+        applies_to: ["frontend"],
+        enabled_by_default: true,
+        generator_file: "engine/topologies/tilt/resources/orchestrator/generators/frontend.star",
+        output_file: ".autogenerated/env.ts",
+    },
+    "api-index": {
+        name: "api-index",
+        description: "Barrel export for clean API client imports",
+        applies_to: ["frontend"],
+        enabled_by_default: true,
+        generator_file: "engine/topologies/tilt/resources/orchestrator/generators/frontend.star",
+        output_file: ".autogenerated/api-index.ts",
+    },
+    // ============================================================================
+    // BACKEND GENERATORS
+    // ============================================================================
+    prisma: {
+        name: "prisma",
+        description: "Prisma CLI configuration for migrations and database client generation",
+        applies_to: ["backend", "worker", "migrator"],
+        enabled_by_default: true,
+        generator_file: "engine/topologies/tilt/generators/typescript/prisma_config.star",
+        output_file: ".autogenerated/prisma.config.autogenerated.ts",
+    },
+    // ============================================================================
+    // BUILD CONFIGURATION GENERATORS (always enabled, not listed in features)
+    // ============================================================================
+    // Note: These always run regardless of features array. They are core to the build.
+    // Listed here for reference only.
+    vite: {
+        name: "vite",
+        description: "Vite configuration for frontend/backend/SDK builds",
+        applies_to: ["frontend", "backend", "sdk"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/generators/vite_config.star",
+        output_file: ".autogenerated/vite.config.*.ts",
+    },
+    tsconfig: {
+        name: "tsconfig",
+        description: "TypeScript configuration (local and Docker variants)",
+        applies_to: ["frontend", "backend", "worker", "migrator", "sdk"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/generators/typescript/",
+        output_file: ".autogenerated/tsconfig.*.json",
+    },
+    dockerfile: {
+        name: "dockerfile",
+        description: "Docker container configuration for production builds",
+        applies_to: ["frontend", "backend", "worker", "migrator", "sdk"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/resources/orchestrator/generators/manifest_resource.star",
+        output_file: ".autogenerated/Dockerfile.app",
+    },
+    npmrc: {
+        name: "npmrc",
+        description: "NPM registry configuration for package installation",
+        applies_to: ["frontend", "backend", "worker", "migrator", "sdk"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/generators/npmrc.star",
+        output_file: ".autogenerated/.npmrc*",
+    },
+    bunfig: {
+        name: "bunfig",
+        description: "Bun runtime configuration for package management",
+        applies_to: ["frontend", "backend", "worker", "migrator", "sdk"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/generators/npmrc.star",
+        output_file: ".autogenerated/bunfig.toml*",
+    },
+    nginx: {
+        name: "nginx",
+        description: "Nginx configuration for static file serving (frontend only)",
+        applies_to: ["frontend"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/generators/nginx_conf.star",
+        output_file: ".autogenerated/nginx.conf",
+    },
+    env: {
+        name: "env",
+        description: "Backend environment file configuration",
+        applies_to: ["backend", "worker", "migrator"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/resources/orchestrator/generators/env.star",
+        output_file: ".autogenerated/.env*",
+    },
+    playwright: {
+        name: "playwright",
+        description: "Playwright test configuration (if playwright: true in manifest)",
+        applies_to: ["frontend", "backend"],
+        enabled_by_default: false, // Only if explicitly enabled in manifest
+        generator_file: "engine/topologies/tilt/generators/typescript/playwright_config.star",
+        output_file: ".autogenerated/playwright.config.ts",
+    },
+    "agents-md": {
+        name: "agents-md",
+        description: "AI agent guard rails for .autogenerated/ folder",
+        applies_to: ["frontend", "backend", "worker", "migrator", "sdk"],
+        enabled_by_default: true, // Always enabled
+        generator_file: "engine/topologies/tilt/generators/agents_md.star",
+        output_file: ".autogenerated/AGENTS.md",
+    },
+};
+/**
+ * Get default features for a resource type
+ */
+export function getDefaultFeaturesForResourceType(appType) {
+    const defaults = [];
+    for (const [key, feature] of Object.entries(RESOURCE_FEATURES)) {
+        if (feature.enabled_by_default &&
+            feature.applies_to.includes(appType) &&
+            // Only include if it's something users control via features array
+            ["api-client", "env-config", "api-index", "prisma"].includes(key)) {
+            defaults.push(key);
+        }
+    }
+    return defaults;
+}
+/**
+ * Get all generators for a resource type (for documentation)
+ */
+export function getGeneratorsForResourceType(appType) {
+    return Object.values(RESOURCE_FEATURES).filter((f) => f.applies_to.includes(appType));
+}
+//# sourceMappingURL=resource-features.js.map

package/dist/utils/resource-features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-features.js","sourceRoot":"","sources":["../../src/utils/resource-features.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,MAAM,CAAC,MAAM,iBAAiB,GAAoC;IAChE,+EAA+E;IAC/E,sBAAsB;IACtB,+EAA+E;IAC/E,YAAY,EAAE;QACZ,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,+EAA+E;QAC5F,UAAU,EAAE,CAAC,UAAU,CAAC;QACxB,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,wEAAwE;QACxF,WAAW,EAAE,8BAA8B;KAC5C;IAED,YAAY,EAAE;QACZ,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,yDAAyD;QACtE,UAAU,EAAE,CAAC,UAAU,CAAC;QACxB,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,wEAAwE;QACxF,WAAW,EAAE,uBAAuB;KACrC;IAED,WAAW,EAAE;QACX,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,4CAA4C;QACzD,UAAU,EAAE,CAAC,UAAU,CAAC;QACxB,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,wEAAwE;QACxF,WAAW,EAAE,6BAA6B;KAC3C;IAED,+EAA+E;IAC/E,qBAAqB;IACrB,+EAA+E;IAC/E,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wEAAwE;QACrF,UAAU,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC;QAC7C,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,iEAAiE;QACjF,WAAW,EAAE,+CAA+C;KAC7D;IAED,+EAA+E;IAC/E,0EAA0E;IAC1E,+EAA+E;IAC/E,mFAAmF;IACnF,kCAAkC;IAElC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,oDAAoD;QACjE,UAAU,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC;QAC1C,kBAAkB,EAAE,IAAI,EAAE,iBAAiB;QAC3C,cAAc,EAAE,oDAAoD;QACpE,WAAW,EAAE,iCAAiC;KAC/C;IAED,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,sDAAsD;QACnE,UAAU,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC;QAChE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB;QAC3C,cAAc,EAAE,+CAA+C;QAC/D,WAAW,EAAE,gCAAgC;KAC9C;IAED,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,sDAAsD;QACnE,UAAU,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC;QAChE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB;QAC3C,cAAc,EAAE,iFAAiF;QACjG,WAAW,EAAE,+BAA+B;KAC7C;IAED,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,qDAAqD;QAClE,UAAU,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC;QAChE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB;QAC3C,cAAc,EAAE,8CAA8C;QAC9D,WAAW,EAAE,wBAAwB;KACtC;IAED,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,kDAAkD;QAC/D,UAAU,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC;QAChE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB;QAC3C,cAAc,EAAE,8CAA8C;QAC9D,WAAW,EAAE,6BAA6B;KAC3C;IAED,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,6DAA6D;QAC1E,UAAU,EAAE,CAAC,UAAU,CAAC;QACxB,kBAAkB,EAAE,IAAI,EAAE,iBAAiB;QAC3C,cAAc,EAAE,mDAAmD;QACnE,WAAW,EAAE,2BAA2B;KACzC;IAED,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,wCAAwC;QACrD,UAAU,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC;QAC7C,kBAAkB,EAAE,IAAI,EAAE,iBAAiB;QAC3C,cAAc,EAAE,mEAAmE;QACnF,WAAW,EAAE,sBAAsB;KACpC;IAED,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,iEAAiE;QAC9E,UAAU,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;QACnC,kBAAkB,EAAE,KAAK,EAAE,yCAAyC;QACpE,cAAc,EAAE,qEAAqE;QACrF,WAAW,EAAE,qCAAqC;KACnD;IAED,WAAW,EAAE;QACX,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,iDAAiD;QAC9D,UAAU,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC;QAChE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB;QAC3C,cAAc,EAAE,kDAAkD;QAClE,WAAW,EAAE,0BAA0B;KACxC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iCAAiC,CAAC,OAAqB;IACrE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC/D,IACE,OAAO,CAAC,kBAAkB;YAC1B,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;YACpC,kEAAkE;YAClE,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EACjE,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAqB;IAChE,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACxF,CAAC"}

package/dist/utils/services.d.ts

@@ -0,0 +1,18 @@
+import type { DiscoveredResource, DiscoveredStack, ResourceMetadata, StackMetadata } from "../types/index.js";
+export declare function discoverResourcesFromRoot(projectRoot: string): DiscoveredResource[];
+export declare function discoverResources(): DiscoveredResource[];
+/**
+ * Unique, sorted `stack` values across discovered service.json files under `projectRoot`.
+ * Tilt's discovery groups services by this same field (see tdk-cli-extensions
+ * discovery_orchestrator.star), so these are the names that must appear in a
+ * stack's `services` list in .tdk/project.json for that group to be enabled.
+ */
+export declare function discoverStackNames(projectRoot: string): string[];
+export declare function getAllStacks(resources?: DiscoveredResource[]): string[];
+export declare function discoverStacks(): DiscoveredStack[];
+export declare function getResourcesForStack(stackName: string): DiscoveredResource[];
+export declare function stackExists(stackName: string): boolean;
+export declare function clearMetadataCache(): void;
+export declare function getResourceMetadata(resource: DiscoveredResource): ResourceMetadata;
+export declare function getStackMetadata(stack: DiscoveredStack): StackMetadata;
+//# sourceMappingURL=services.d.ts.map

package/dist/utils/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/utils/services.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,kBAAkB,EAClB,eAAe,EAGf,gBAAgB,EAEhB,aAAa,EACd,MAAM,mBAAmB,CAAC;AA6E3B,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,EAAE,CASnF;AAED,wBAAgB,iBAAiB,IAAI,kBAAkB,EAAE,CAUxD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAWhE;AAED,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAWvE;AAED,wBAAgB,cAAc,IAAI,eAAe,EAAE,CA0BlD;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAG5E;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGtD;AAWD,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AA4BD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,gBAAgB,CAwDlF;AA0CD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,CA0CtE"}