@lightdash/cli 1.53.0 → 1.55.0

package/dist/handlers/apps/appCodeFiles.d.ts

@@ -12,6 +12,7 @@ export declare const buildImportBody: (code: DataAppCode, targetProjectUuid: str
     app?: string;
     space?: string;
     createNew?: boolean;
+    force?: boolean;
 }) => ImportAppCodeRequestBody;
 /**
  * The persistent slug from a slug-aware server is the folder name (stable
@@ -53,6 +54,11 @@ export declare const applySdkMirrorToTemplateDeps: (templateDependencies: Record
  * deps (payload stays identical to today's format).
  */
 export declare const attachDependenciesToCode: (code: DataAppCode, customDeps: Record<string, string>, deps: DataAppDependencies) => DataAppCode;
+/**
+ * Mirrors the chart/dashboard rule: changed when a file that actually gets
+ * uploaded has drifted more than 30s from the manifest's downloadedAt.
+ */
+export declare const appFolderNeedsUpdating: (dir: string, manifest: DataAppManifest) => Promise<boolean>;
 export declare const readManifestFromDir: (dir: string) => Promise<DataAppManifest>;
 export declare const readBundleFromDir: (dir: string) => Promise<DataAppCode>;
 //# sourceMappingURL=appCodeFiles.d.ts.map

package/dist/handlers/apps/appCodeFiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appCodeFiles.d.ts","sourceRoot":"","sources":["../../../src/handlers/apps/appCodeFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAKH,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EAEnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAChC,MAAM,mBAAmB,CAAC;AAO3B;;;;GAIG;AACH,eAAO,MAAM,aAAa,SAChB,MAAM,WACH,MAAM,gBACD,GAAG,CAAC,MAAM,CAAC,KAC1B,MAcF,CAAC;AAEF,eAAO,MAAM,eAAe,QACnB,MAAM,SACJ,eAAe,EAAE,KACzB,OAAO,CAAC,IAAI,CAsBd,CAAC;AAEF,eAAO,MAAM,iBAAiB,QACrB,MAAM,WACF,cAAc,KACxB,OAAO,CAAC,IAAI,CASd,CAAC;AAEF,eAAO,MAAM,gBAAgB,QACpB,MAAM,QACL,WAAW,KAClB,OAAO,CAAC,IAAI,CAWd,CAAC;AAmCF,eAAO,MAAM,eAAe,SAClB,WAAW,qBACE,MAAM,QACnB;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,KAC5D,wBAoBF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,aACnB,eAAe,gBACX,GAAG,CAAC,MAAM,CAAC,KAC1B,MAgBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAC1B,MAAM,QACL,mBAAmB,KAC1B,OAAO,CAAC,IAAI,CAGd,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAC;IAKpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAC3B,MAAM,KACZ,OAAO,CAAC,oBAAoB,GAAG,IAAI,CA6BrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,eAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,wBACZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC7C,MAAM,EAOH,CAAC;AAEP;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,yBACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,eAC/B,MAAM,KACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAgBvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,SAC3B,WAAW,cACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAC5B,mBAAmB,KAC1B,WAC4E,CAAC;AAEhF,eAAO,MAAM,mBAAmB,QACvB,MAAM,KACZ,OAAO,CAAC,eAAe,CAYzB,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAe,MAAM,KAAG,OAAO,CAAC,WAAW,CAYxE,CAAC"}
+{"version":3,"file":"appCodeFiles.d.ts","sourceRoot":"","sources":["../../../src/handlers/apps/appCodeFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAKH,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EAEnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAChC,MAAM,mBAAmB,CAAC;AAO3B;;;;GAIG;AACH,eAAO,MAAM,aAAa,SAChB,MAAM,WACH,MAAM,gBACD,GAAG,CAAC,MAAM,CAAC,KAC1B,MAcF,CAAC;AAEF,eAAO,MAAM,eAAe,QACnB,MAAM,SACJ,eAAe,EAAE,KACzB,OAAO,CAAC,IAAI,CAsBd,CAAC;AAEF,eAAO,MAAM,iBAAiB,QACrB,MAAM,WACF,cAAc,KACxB,OAAO,CAAC,IAAI,CASd,CAAC;AAEF,eAAO,MAAM,gBAAgB,QACpB,MAAM,QACL,WAAW,KAClB,OAAO,CAAC,IAAI,CAWd,CAAC;AAmCF,eAAO,MAAM,eAAe,SAClB,WAAW,qBACE,MAAM,QACnB;IACF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,KACF,wBAqBF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,aACnB,eAAe,gBACX,GAAG,CAAC,MAAM,CAAC,KAC1B,MAgBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAC1B,MAAM,QACL,mBAAmB,KAC1B,OAAO,CAAC,IAAI,CAGd,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAC;IAKpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAC3B,MAAM,KACZ,OAAO,CAAC,oBAAoB,GAAG,IAAI,CA6BrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,eAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,wBACZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC7C,MAAM,EAOH,CAAC;AAEP;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,yBACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,eAC/B,MAAM,KACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAgBvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,SAC3B,WAAW,cACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAC5B,mBAAmB,KAC1B,WAC4E,CAAC;AAuBhF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAC1B,MAAM,YACD,eAAe,KAC1B,OAAO,CAAC,OAAO,CAqBjB,CAAC;AAEF,eAAO,MAAM,mBAAmB,QACvB,MAAM,KACZ,OAAO,CAAC,eAAe,CAYzB,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAe,MAAM,KAAG,OAAO,CAAC,WAAW,CAYxE,CAAC"}

package/dist/handlers/apps/appCodeFiles.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readBundleFromDir = exports.readManifestFromDir = exports.attachDependenciesToCode = exports.applySdkMirrorToTemplateDeps = exports.buildDepsWarningLines = exports.readDependenciesFromDir = exports.writeDependenciesToDir = exports.resolveAppFolderName = exports.buildImportBody = exports.writeBundleToDir = exports.writeContextToDir = exports.writeFilesToDir = exports.appFolderName = void 0;
+exports.readBundleFromDir = exports.readManifestFromDir = exports.appFolderNeedsUpdating = exports.attachDependenciesToCode = exports.applySdkMirrorToTemplateDeps = exports.buildDepsWarningLines = exports.readDependenciesFromDir = exports.writeDependenciesToDir = exports.resolveAppFolderName = exports.buildImportBody = exports.writeBundleToDir = exports.writeContextToDir = exports.writeFilesToDir = exports.appFolderName = void 0;
 const tslib_1 = require("tslib");
 const common_1 = require("@lightdash/common");
 const fs_1 = require("fs");
@@ -105,6 +105,7 @@ const buildImportBody = (code, targetProjectUuid, opts) => {
         targetAppUuid,
         spaceUuid: opts.space,
         ...(opts.createNew ? { createNew: true } : {}),
+        ...(opts.force ? { force: true } : {}),
     };
 };
 exports.buildImportBody = buildImportBody;
@@ -209,6 +210,46 @@ exports.applySdkMirrorToTemplateDeps = applySdkMirrorToTemplateDeps;
  */
 const attachDependenciesToCode = (code, customDeps, deps) => Object.keys(customDeps).length > 0 ? { ...code, dependencies: deps } : code;
 exports.attachDependenciesToCode = attachDependenciesToCode;
+const CHANGE_TOLERANCE_MS = 30_000;
+const collectMtimes = async (dir) => {
+    const entries = await fs_1.promises.readdir(dir, { withFileTypes: true });
+    const nested = await Promise.all(entries.map(async (entry) => {
+        const entryPath = path.join(dir, entry.name);
+        if (entry.isDirectory())
+            return collectMtimes(entryPath);
+        const stats = await fs_1.promises.stat(entryPath);
+        return [stats.mtime.getTime()];
+    }));
+    return nested.flat();
+};
+const statMtime = async (file) => fs_1.promises
+    .stat(file)
+    .then((stats) => [stats.mtime.getTime()])
+    .catch(() => []);
+/**
+ * Mirrors the chart/dashboard rule: changed when a file that actually gets
+ * uploaded has drifted more than 30s from the manifest's downloadedAt.
+ */
+const appFolderNeedsUpdating = async (dir, manifest) => {
+    if (!manifest.downloadedAt)
+        return true;
+    const downloadedAt = new Date(manifest.downloadedAt).getTime();
+    if (Number.isNaN(downloadedAt))
+        return true;
+    const srcDir = path.join(dir, 'src');
+    const srcExists = await fs_1.promises
+        .stat(srcDir)
+        .then((s) => s.isDirectory())
+        .catch(() => false);
+    const mtimes = [
+        ...(srcExists ? await collectMtimes(srcDir) : []),
+        ...(await statMtime(path.join(dir, 'package.json'))),
+        ...(await statMtime(path.join(dir, 'pnpm-lock.yaml'))),
+        ...(await statMtime(path.join(dir, MANIFEST_FILENAME))),
+    ];
+    return mtimes.some((mtime) => Math.abs(mtime - downloadedAt) > CHANGE_TOLERANCE_MS);
+};
+exports.appFolderNeedsUpdating = appFolderNeedsUpdating;
 const readManifestFromDir = async (dir) => {
     const manifestRaw = await fs_1.promises.readFile(path.join(dir, MANIFEST_FILENAME), 'utf-8');
     try {

package/dist/handlers/apps/appCodeFiles.test.js

@@ -349,3 +349,63 @@ describe('applySdkMirrorToTemplateDeps', () => {
         expect((0, appCodeFiles_1.applySdkMirrorToTemplateDeps)(template, 'not-json')).toEqual(template);
     });
 });
+// ─── appFolderNeedsUpdating ────────────────────────────────────────────────────
+describe('appFolderNeedsUpdating', () => {
+    const DOWNLOADED_AT = '2026-07-30T12:00:00.000Z';
+    const manifest = { downloadedAt: DOWNLOADED_AT };
+    const buildFolder = () => {
+        const dir = (0, fs_1.mkdtempSync)(path.join(os.tmpdir(), 'ld-app-folder-'));
+        (0, fs_1.mkdirSync)(path.join(dir, 'src'), { recursive: true });
+        (0, fs_1.writeFileSync)(path.join(dir, 'src', 'App.tsx'), 'x');
+        (0, fs_1.writeFileSync)(path.join(dir, 'lightdash-app.yml'), 'slug: x');
+        (0, fs_1.mkdirSync)(path.join(dir, '.lightdash', 'context'), {
+            recursive: true,
+        });
+        (0, fs_1.writeFileSync)(path.join(dir, '.lightdash', 'context', 'semantic-layer.yml'), 'models: []');
+        const at = new Date(DOWNLOADED_AT);
+        [
+            path.join(dir, 'src', 'App.tsx'),
+            path.join(dir, 'lightdash-app.yml'),
+            path.join(dir, '.lightdash', 'context', 'semantic-layer.yml'),
+        ].forEach((file) => (0, fs_1.utimesSync)(file, at, at));
+        return dir;
+    };
+    it('is false for a freshly downloaded folder', async () => {
+        await expect((0, appCodeFiles_1.appFolderNeedsUpdating)(buildFolder(), manifest)).resolves.toBe(false);
+    });
+    it('is true when a src file was edited', async () => {
+        const dir = buildFolder();
+        const later = new Date('2026-07-30T13:00:00.000Z');
+        (0, fs_1.utimesSync)(path.join(dir, 'src', 'App.tsx'), later, later);
+        await expect((0, appCodeFiles_1.appFolderNeedsUpdating)(dir, manifest)).resolves.toBe(true);
+    });
+    it('is true when the manifest was edited', async () => {
+        const dir = buildFolder();
+        const later = new Date('2026-07-30T13:00:00.000Z');
+        (0, fs_1.utimesSync)(path.join(dir, 'lightdash-app.yml'), later, later);
+        await expect((0, appCodeFiles_1.appFolderNeedsUpdating)(dir, manifest)).resolves.toBe(true);
+    });
+    it('ignores regenerated context files', async () => {
+        const dir = buildFolder();
+        const later = new Date('2026-07-30T13:00:00.000Z');
+        (0, fs_1.utimesSync)(path.join(dir, '.lightdash', 'context', 'semantic-layer.yml'), later, later);
+        await expect((0, appCodeFiles_1.appFolderNeedsUpdating)(dir, manifest)).resolves.toBe(false);
+    });
+    it('is true when downloadedAt is missing', async () => {
+        await expect((0, appCodeFiles_1.appFolderNeedsUpdating)(buildFolder(), {})).resolves.toBe(true);
+    });
+    it('is true when downloadedAt is unparseable', async () => {
+        await expect((0, appCodeFiles_1.appFolderNeedsUpdating)(buildFolder(), {
+            downloadedAt: 'not-a-date',
+        })).resolves.toBe(true);
+    });
+    it('is true when a nested src file was edited', async () => {
+        const dir = buildFolder();
+        (0, fs_1.mkdirSync)(path.join(dir, 'src', 'components'), { recursive: true });
+        const nested = path.join(dir, 'src', 'components', 'Chart.tsx');
+        (0, fs_1.writeFileSync)(nested, 'x');
+        const later = new Date('2026-07-30T13:00:00.000Z');
+        (0, fs_1.utimesSync)(nested, later, later);
+        await expect((0, appCodeFiles_1.appFolderNeedsUpdating)(dir, manifest)).resolves.toBe(true);
+    });
+});

package/dist/handlers/apps/appsDownload.d.ts

@@ -61,6 +61,16 @@ export declare const capListedApps: (listedUuids: string[], limit: number) => {
     appUuids: string[];
     truncatedCount: number;
 };
+/**
+ * Data apps a dashboard needs that aren't already covered by an explicit
+ * --apps ref, or by a (possibly --apps-limit-truncated) --include-apps listing.
+ */
+export declare const computeLinkedAppSlugs: (args: {
+    appSlugs: string[];
+    explicitRefs: Set<string>;
+    includeApps: boolean;
+    cappedAppSlugs: Set<string>;
+}) => string[];
 /**
  * Pre-context servers return a download payload without `context`.
  */
@@ -73,6 +83,25 @@ export declare const preSlugUploadHint: (args: {
     folder: string;
     slug: string | undefined;
 }) => string;
+export type AppPresence = {
+    kind: 'known';
+    slugs: Set<string>;
+} | {
+    kind: 'unknown';
+    targetProjectUuid: string;
+};
+/**
+ * Auto-pushed apps normally upload only when the folder changed, because every
+ * upload triggers a sandbox rebuild. The exception is an app the target project
+ * does not have yet — without it a dashboard moved to a new project or instance
+ * lands with its tile skipped.
+ */
+export declare const shouldAutoPushApp: (args: {
+    manifest: Pick<DataAppManifest, 'slug' | 'projectUuid'>;
+    presence: AppPresence;
+    folderChanged: boolean;
+    force: boolean;
+}) => boolean;
 export type AppDownloadFailure = {
     appRef: string;
     message: string;
@@ -106,4 +135,24 @@ export declare const appsDownloadSummary: (successCount: number, total: number,
     message: string;
     failureLines: string[];
 };
+export type AppsDownloadOutcome = {
+    successCount: number;
+    skippedNotBuiltCount: number;
+    failures: AppDownloadFailure[];
+};
+/**
+ * Downloads each app to its own folder under appsDir, classifying "no built
+ * version" 404s as skips rather than failures. Everything the loop needs
+ * (fetching, versioning, progress reporting) is injected so this stays free
+ * of any dependency on the download handler.
+ */
+export declare const downloadAppsToDir: (args: {
+    appRefs: string[];
+    projectId: string;
+    appsDir: string;
+    takenFolders: Set<string>;
+    cliVersion: string;
+    fetchApp: (projectId: string, appRef: string) => Promise<DataAppCodeDownload>;
+    onProgress?: (processed: number, total: number) => void;
+}) => Promise<AppsDownloadOutcome>;
 //# sourceMappingURL=appsDownload.d.ts.map

package/dist/handlers/apps/appsDownload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appsDownload.d.ts","sourceRoot":"","sources":["../../../src/handlers/apps/appsDownload.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"appsDownload.d.ts","sourceRoot":"","sources":["../../../src/handlers/apps/appsDownload.ts"],"names":[],"mappings":"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"}

package/dist/handlers/apps/appsDownload.js

@@ -1,8 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.appsDownloadSummary = exports.shouldWarnAllSkipped = exports.computeUpsertedTotal = exports.classifyAppDownloadError = exports.preSlugUploadHint = exports.ensureDownloadedAppContext = exports.capListedApps = exports.selectAppsToDownload = exports.shouldFallBackToSpaceScopedListing = exports.resolveAppsLimit = exports.preSlugServerHint = exports.unmatchedUploadRefsWarning = exports.matchedUploadRefs = exports.uploadFilterMatches = exports.getDataAppUploadFilter = exports.getDataAppReference = exports.DEFAULT_APPS_LIMIT = void 0;
+exports.downloadAppsToDir = exports.appsDownloadSummary = exports.shouldWarnAllSkipped = exports.computeUpsertedTotal = exports.classifyAppDownloadError = exports.shouldAutoPushApp = exports.preSlugUploadHint = exports.ensureDownloadedAppContext = exports.computeLinkedAppSlugs = exports.capListedApps = exports.selectAppsToDownload = exports.shouldFallBackToSpaceScopedListing = exports.resolveAppsLimit = exports.preSlugServerHint = exports.unmatchedUploadRefsWarning = exports.matchedUploadRefs = exports.uploadFilterMatches = exports.getDataAppUploadFilter = exports.getDataAppReference = exports.DEFAULT_APPS_LIMIT = void 0;
+const tslib_1 = require("tslib");
 const common_1 = require("@lightdash/common");
+const path = tslib_1.__importStar(require("path"));
 const uuid_1 = require("uuid");
+const globalState_1 = tslib_1.__importDefault(require("../../globalState"));
+const styles = tslib_1.__importStar(require("../../styles"));
+const appCodeFiles_1 = require("./appCodeFiles");
+const scaffolding_1 = require("./scaffolding");
 exports.DEFAULT_APPS_LIMIT = 50;
 const getDataAppReference = (reference) => {
     let url;
@@ -106,6 +112,16 @@ const capListedApps = (listedUuids, limit) => ({
     truncatedCount: Math.max(0, listedUuids.length - limit),
 });
 exports.capListedApps = capListedApps;
+/**
+ * Data apps a dashboard needs that aren't already covered by an explicit
+ * --apps ref, or by a (possibly --apps-limit-truncated) --include-apps listing.
+ */
+const computeLinkedAppSlugs = (args) => {
+    const { appSlugs, explicitRefs, includeApps, cappedAppSlugs } = args;
+    return appSlugs.filter((slug) => !explicitRefs.has(slug) &&
+        !(includeApps && cappedAppSlugs.has(slug)));
+};
+exports.computeLinkedAppSlugs = computeLinkedAppSlugs;
 /**
  * Pre-context servers return a download payload without `context`.
  */
@@ -124,6 +140,23 @@ const preSlugUploadHint = (args) => `${args.folder}/lightdash-app.yml predates s
     ? ` (or add \`slug: ${args.slug}\` to lightdash-app.yml)`
     : ''}. Uploads keep working via uuid matching meanwhile.`;
 exports.preSlugUploadHint = preSlugUploadHint;
+/**
+ * Auto-pushed apps normally upload only when the folder changed, because every
+ * upload triggers a sandbox rebuild. The exception is an app the target project
+ * does not have yet — without it a dashboard moved to a new project or instance
+ * lands with its tile skipped.
+ */
+const shouldAutoPushApp = (args) => {
+    if (args.force || args.folderChanged)
+        return true;
+    if (args.manifest.slug === undefined)
+        return true;
+    if (args.presence.kind === 'known') {
+        return !args.presence.slugs.has(args.manifest.slug);
+    }
+    return args.manifest.projectUuid !== args.presence.targetProjectUuid;
+};
+exports.shouldAutoPushApp = shouldAutoPushApp;
 /**
  * A 404 saying the app has no ready version means it exists but never
  * finished a successful build — nothing to download, so it's a skip, not a
@@ -185,3 +218,59 @@ const appsDownloadSummary = (successCount, total, failures, appsDir, skippedNotB
     };
 };
 exports.appsDownloadSummary = appsDownloadSummary;
+/**
+ * Downloads each app to its own folder under appsDir, classifying "no built
+ * version" 404s as skips rather than failures. Everything the loop needs
+ * (fetching, versioning, progress reporting) is injected so this stays free
+ * of any dependency on the download handler.
+ */
+const downloadAppsToDir = async (args) => {
+    const { appRefs, projectId, appsDir, takenFolders, cliVersion, fetchApp, onProgress, } = args;
+    let successCount = 0;
+    let skippedNotBuiltCount = 0;
+    const failures = [];
+    for (const appRef of appRefs) {
+        try {
+            const code = (0, exports.ensureDownloadedAppContext)(appRef, 
+            // eslint-disable-next-line no-await-in-loop
+            await fetchApp(projectId, appRef));
+            const folder = (0, appCodeFiles_1.resolveAppFolderName)(code.manifest, takenFolders);
+            takenFolders.add(folder);
+            const appDir = path.join(appsDir, folder);
+            const manifest = {
+                ...code.manifest,
+                scaffoldingVersion: cliVersion,
+            };
+            // eslint-disable-next-line no-await-in-loop
+            await (0, appCodeFiles_1.writeBundleToDir)(appDir, { ...code, manifest });
+            // eslint-disable-next-line no-await-in-loop
+            await (0, appCodeFiles_1.writeFilesToDir)(appDir, (0, scaffolding_1.buildStaticAuthoringFiles)({
+                appName: code.manifest.name,
+                sdkVersion: cliVersion,
+            }));
+            // Server-provided deps override the scaffold's
+            // template package.json so re-uploads round-trip.
+            if (code.dependencies) {
+                // eslint-disable-next-line no-await-in-loop
+                await (0, appCodeFiles_1.writeDependenciesToDir)(appDir, code.dependencies);
+            }
+            // eslint-disable-next-line no-await-in-loop
+            await (0, appCodeFiles_1.writeContextToDir)(appDir, code.context);
+            successCount += 1;
+        }
+        catch (appErr) {
+            const outcome = (0, exports.classifyAppDownloadError)(appErr);
+            if (outcome.kind === 'skip-not-built') {
+                skippedNotBuiltCount += 1;
+                globalState_1.default.debug(`> Skipped app ${appRef}: no built version to download`);
+            }
+            else {
+                failures.push({ appRef, message: outcome.message });
+                globalState_1.default.log(styles.error(`Failed to download app ${appRef}: ${outcome.message}`));
+            }
+        }
+        onProgress?.(successCount + skippedNotBuiltCount + failures.length, appRefs.length);
+    }
+    return { successCount, skippedNotBuiltCount, failures };
+};
+exports.downloadAppsToDir = downloadAppsToDir;

package/dist/handlers/apps/appsDownload.test.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
 const common_1 = require("@lightdash/common");
+const fs = tslib_1.__importStar(require("fs"));
+const os = tslib_1.__importStar(require("os"));
+const path = tslib_1.__importStar(require("path"));
 const appsDownload_1 = require("./appsDownload");
 describe('getDataAppReference', () => {
     const appUuid = 'd3afc44c-6f0f-4d9f-a267-fb739efa31dd';
@@ -158,6 +162,59 @@ describe('capListedApps', () => {
         });
     });
 });
+describe('computeLinkedAppSlugs', () => {
+    it('returns dashboard-referenced slugs unchanged when apps are not opted in at all', () => {
+        expect((0, appsDownload_1.computeLinkedAppSlugs)({
+            appSlugs: ['revenue-explorer', 'sales-dash'],
+            explicitRefs: new Set(),
+            includeApps: false,
+            cappedAppSlugs: new Set(),
+        })).toEqual(['revenue-explorer', 'sales-dash']);
+    });
+    it('excludes slugs already covered by an explicit --apps ref', () => {
+        expect((0, appsDownload_1.computeLinkedAppSlugs)({
+            appSlugs: ['revenue-explorer', 'sales-dash'],
+            explicitRefs: new Set(['revenue-explorer']),
+            includeApps: false,
+            cappedAppSlugs: new Set(),
+        })).toEqual(['sales-dash']);
+    });
+    it('excludes everything already inside an untruncated --include-apps listing', () => {
+        expect((0, appsDownload_1.computeLinkedAppSlugs)({
+            appSlugs: ['revenue-explorer', 'sales-dash'],
+            explicitRefs: new Set(),
+            includeApps: true,
+            cappedAppSlugs: new Set(['revenue-explorer', 'sales-dash']),
+        })).toEqual([]);
+    });
+    // PROD-9089 regression: --include-apps caps its listing at --apps-limit,
+    // so a dashboard's app can fall outside the capped set. It must still be
+    // downloaded via the linked step rather than silently dropped.
+    it('keeps slugs that fell outside a truncated --include-apps listing', () => {
+        expect((0, appsDownload_1.computeLinkedAppSlugs)({
+            appSlugs: ['revenue-explorer', 'sales-dash'],
+            explicitRefs: new Set(),
+            includeApps: true,
+            cappedAppSlugs: new Set(['sales-dash']),
+        })).toEqual(['revenue-explorer']);
+    });
+    it('an explicit ref wins over include-apps capping (never double counted)', () => {
+        expect((0, appsDownload_1.computeLinkedAppSlugs)({
+            appSlugs: ['revenue-explorer'],
+            explicitRefs: new Set(['revenue-explorer']),
+            includeApps: true,
+            cappedAppSlugs: new Set(),
+        })).toEqual([]);
+    });
+    it('returns an empty array when no dashboards reference any app', () => {
+        expect((0, appsDownload_1.computeLinkedAppSlugs)({
+            appSlugs: [],
+            explicitRefs: new Set(['other-app']),
+            includeApps: true,
+            cappedAppSlugs: new Set(),
+        })).toEqual([]);
+    });
+});
 describe('resolveAppsLimit', () => {
     it('defaults to DEFAULT_APPS_LIMIT when the flag is not passed', () => {
         expect(appsDownload_1.DEFAULT_APPS_LIMIT).toBe(50);
@@ -400,3 +457,177 @@ describe('appsDownloadSummary', () => {
         expect(summary.message).toContain('1 failed');
     });
 });
+describe('downloadAppsToDir', () => {
+    const tmpDir = () => fs.mkdtempSync(path.join(os.tmpdir(), 'ld-apps-download-'));
+    const codeFor = (slug) => ({
+        manifest: {
+            codeVersion: 1,
+            projectUuid: 'project-uuid',
+            slug,
+            version: 1,
+            name: slug,
+            description: '',
+            template: null,
+            downloadedAt: '2026-07-30T00:00:00.000Z',
+        },
+        files: [
+            {
+                path: 'src/App.tsx',
+                contentBase64: Buffer.from('export default () => null;').toString('base64'),
+            },
+        ],
+        context: {
+            semanticLayer: {
+                path: '.lightdash/context/semantic-layer.yml',
+                contentBase64: Buffer.from('models: []').toString('base64'),
+            },
+            parameters: null,
+            promptHistory: {
+                path: '.lightdash/context/prompt-history.md',
+                contentBase64: Buffer.from('# history').toString('base64'),
+            },
+            theme: { instructions: null, assets: [], skippedAssetCount: 0 },
+        },
+    });
+    it('writes one folder per app and counts successes', async () => {
+        const appsDir = tmpDir();
+        const outcome = await (0, appsDownload_1.downloadAppsToDir)({
+            appRefs: ['revenue-explorer'],
+            projectId: 'project-uuid',
+            appsDir,
+            takenFolders: new Set(),
+            cliVersion: '0.0.0-test',
+            fetchApp: async (_p, ref) => codeFor(ref),
+        });
+        expect(outcome).toEqual({
+            successCount: 1,
+            skippedNotBuiltCount: 0,
+            failures: [],
+        });
+        expect(fs.existsSync(path.join(appsDir, 'revenue-explorer', 'lightdash-app.yml'))).toBe(true);
+    });
+    it('writes server-provided dependencies over the scaffold template package.json', async () => {
+        const appsDir = tmpDir();
+        const packageJson = JSON.stringify({
+            name: 'server-provided',
+            dependencies: {},
+        });
+        const lockfile = 'lockfileVersion: 6.0\nserver: provided\n';
+        const outcome = await (0, appsDownload_1.downloadAppsToDir)({
+            appRefs: ['deps-app'],
+            projectId: 'project-uuid',
+            appsDir,
+            takenFolders: new Set(),
+            cliVersion: '0.0.0-test',
+            fetchApp: async (_p, ref) => ({
+                ...codeFor(ref),
+                dependencies: { packageJson, lockfile },
+            }),
+        });
+        expect(outcome.successCount).toBe(1);
+        const writtenPackageJson = fs.readFileSync(path.join(appsDir, 'deps-app', 'package.json'), 'utf-8');
+        expect(writtenPackageJson).toBe(packageJson);
+        const writtenLockfile = fs.readFileSync(path.join(appsDir, 'deps-app', 'pnpm-lock.yaml'), 'utf-8');
+        expect(writtenLockfile).toBe(lockfile);
+    });
+    it('counts an app with no ready version as skipped, not failed', async () => {
+        const outcome = await (0, appsDownload_1.downloadAppsToDir)({
+            appRefs: ['half-built'],
+            projectId: 'project-uuid',
+            appsDir: tmpDir(),
+            takenFolders: new Set(),
+            cliVersion: '0.0.0-test',
+            fetchApp: async () => {
+                throw new common_1.LightdashError({
+                    message: 'App has no ready version to download',
+                    name: 'NotFoundError',
+                    statusCode: 404,
+                    data: {},
+                });
+            },
+        });
+        expect(outcome.skippedNotBuiltCount).toBe(1);
+        expect(outcome.failures).toEqual([]);
+    });
+});
+describe('shouldAutoPushApp', () => {
+    const manifest = {
+        slug: 'revenue-explorer',
+        projectUuid: 'source-project',
+    };
+    const known = (...slugs) => ({
+        kind: 'known',
+        slugs: new Set(slugs),
+    });
+    it('pushes when the target project does not have the app', () => {
+        expect((0, appsDownload_1.shouldAutoPushApp)({
+            manifest,
+            presence: known(),
+            folderChanged: false,
+            force: false,
+        })).toBe(true);
+    });
+    it('pushes when the app exists and the folder changed', () => {
+        expect((0, appsDownload_1.shouldAutoPushApp)({
+            manifest,
+            presence: known('revenue-explorer'),
+            folderChanged: true,
+            force: false,
+        })).toBe(true);
+    });
+    it('skips when the app exists and nothing changed', () => {
+        expect((0, appsDownload_1.shouldAutoPushApp)({
+            manifest,
+            presence: known('revenue-explorer'),
+            folderChanged: false,
+            force: false,
+        })).toBe(false);
+    });
+    it('pushes an unchanged existing app under --force', () => {
+        expect((0, appsDownload_1.shouldAutoPushApp)({
+            manifest,
+            presence: known('revenue-explorer'),
+            folderChanged: false,
+            force: true,
+        })).toBe(true);
+    });
+    it('falls back to the project comparison when presence is unknown', () => {
+        expect((0, appsDownload_1.shouldAutoPushApp)({
+            manifest,
+            presence: {
+                kind: 'unknown',
+                targetProjectUuid: 'other-project',
+            },
+            folderChanged: false,
+            force: false,
+        })).toBe(true);
+        expect((0, appsDownload_1.shouldAutoPushApp)({
+            manifest,
+            presence: {
+                kind: 'unknown',
+                targetProjectUuid: 'source-project',
+            },
+            folderChanged: false,
+            force: false,
+        })).toBe(false);
+    });
+    it('pushes a slug-less manifest so a pre-slug bundle still lands', () => {
+        expect((0, appsDownload_1.shouldAutoPushApp)({
+            manifest: { slug: undefined, projectUuid: 'source-project' },
+            presence: known('revenue-explorer'),
+            folderChanged: false,
+            force: false,
+        })).toBe(true);
+    });
+    it('pushes a slug-less manifest against an older server with unknown presence', () => {
+        expect((0, appsDownload_1.shouldAutoPushApp)({
+            manifest: { slug: undefined, projectUuid: 'source-project' },
+            presence: {
+                kind: 'unknown',
+                targetProjectUuid: 'source-project',
+            },
+            folderChanged: false,
+            force: false,
+        })).toBe(true);
+    });
+});

package/dist/handlers/download.d.ts

@@ -59,7 +59,15 @@ type MetadataEntry = {
 };
 declare const sanitizeChartForDownload: (chart: ChartAsCode, stripPivotSeries: boolean) => ChartAsCode;
 type DownloadContentType = 'charts' | 'dashboards' | 'sqlCharts';
-export declare const downloadContent: (ids: string[], type: DownloadContentType, projectId: string, projectName: string, customPath?: string, languageMap?: boolean, nested?: boolean, skipSpaces?: boolean, stripPivotSeries?: boolean, rootSpaces?: boolean, onProgress?: (detail: string) => void) => Promise<[number, string[], MetadataEntry[], SpaceAsCode[]]>;
+declare const extractAppSlugsFromDashboards: (dashboards: DashboardAsCode[]) => string[];
+export type DownloadContentResult = {
+    total: number;
+    chartSlugs: string[];
+    appSlugs: string[];
+    metadataEntries: MetadataEntry[];
+    spaces: SpaceAsCode[];
+};
+export declare const downloadContent: (ids: string[], type: DownloadContentType, projectId: string, projectName: string, customPath?: string, languageMap?: boolean, nested?: boolean, skipSpaces?: boolean, stripPivotSeries?: boolean, rootSpaces?: boolean, onProgress?: (detail: string) => void) => Promise<DownloadContentResult>;
 declare const upsertVirtualViews: (projectId: string, slugs: string[], changes: Record<string, number>, force: boolean, canUpload: boolean, customPath?: string) => Promise<Record<string, number>>;
 export declare const getExternalConnectionSecretEnvVar: (slug: string) => string;
 /**
@@ -84,16 +92,23 @@ declare const summarizeUploadChanges: (before: Record<string, number>, after: Re
 declare const getDashboardChartSlugs: (dashboardSlugs: string[], customPath?: string, looseDashboards?: (DashboardAsCode & {
     needsUpdating: boolean;
 })[]) => Promise<string[]>;
+declare const getDashboardAppSlugs: (dashboardSlugs: string[], customPath?: string, looseDashboards?: (DashboardAsCode & {
+    needsUpdating: boolean;
+})[]) => Promise<string[]>;
+declare const isFilteredWithNoDashboards: (hasFilters: boolean, dashboardSlugs: string[]) => boolean;
 export declare const uploadHandler: (options: DownloadHandlerOptions) => Promise<void>;
 export declare const testHelpers: {
     assertUniqueSpacePaths: typeof assertUniqueSpacePaths;
     downloadSpaces: typeof downloadSpaces;
+    extractAppSlugsFromDashboards: typeof extractAppSlugsFromDashboards;
     getFlatSpaceFileNames: typeof getFlatSpaceFileNames;
+    getDashboardAppSlugs: typeof getDashboardAppSlugs;
     getDashboardChartSlugs: typeof getDashboardChartSlugs;
     hasContentFilters: typeof hasContentFilters;
     isAiAgentsUnavailableError: typeof isAiAgentsUnavailableError;
     isExternalConnectionsUnavailableError: typeof isExternalConnectionsUnavailableError;
     downloadAiAgents: typeof downloadAiAgents;
+    isFilteredWithNoDashboards: typeof isFilteredWithNoDashboards;
     readAiAgentFiles: typeof readAiAgentFiles;
     readExternalConnectionFiles: typeof readExternalConnectionFiles;
     readSpaceFiles: typeof readSpaceFiles;