fix(node): honor describe labels and stale bundles

Author: kvz

packages/node/src/cli/commands/assemblies.ts

@@ -671,12 +671,14 @@ async function shouldSkipStaleOutput({
   outputPlanMtime,
   outputRootIsDirectory,
   reprocessStale,
+  singleInputReference = 'output-plan',
 }: {
   inputPaths: string[]
   outputPath: string | null
   outputPlanMtime: Date
   outputRootIsDirectory: boolean
   reprocessStale?: boolean
+  singleInputReference?: 'input' | 'output-plan'
 }): Promise<boolean> {
   if (reprocessStale || outputPath == null || outputRootIsDirectory) {
     return false
@@ -692,7 +694,16 @@ async function shouldSkipStaleOutput({
   }
 
   if (inputPaths.length === 1) {
-    return isMeaningfullyNewer(outputStat.mtime, outputPlanMtime)
+    if (singleInputReference === 'output-plan') {
+      return isMeaningfullyNewer(outputStat.mtime, outputPlanMtime)
+    }
+
+    const [inputErr, inputStat] = await tryCatch(fsp.stat(inputPaths[0]))
+    if (inputErr != null || inputStat == null) {
+      return false
+    }
+
+    return isMeaningfullyNewer(outputStat.mtime, inputStat.mtime)
   }
 
   const inputStats = await Promise.all(
@@ -1442,6 +1453,7 @@ export async function create(
             outputPlanMtime: new Date(0),
             outputRootIsDirectory,
             reprocessStale,
+            singleInputReference: 'input',
           })
         ) {
           outputctl.debug(`SKIPPED STALE SINGLE ASSEMBLY ${resolvedOutput ?? 'null'}`)

packages/node/src/cli/semanticIntents/imageDescribe.ts

@@ -118,10 +118,7 @@ function resolveRequestedDescribeFields({
   explicitFields: ImageDescribeField[]
   profile: 'wordpress' | null
 }): ImageDescribeField[] {
-  if (
-    explicitFields.length > 0 &&
-    !(explicitFields.length === 1 && explicitFields[0] === 'labels')
-  ) {
+  if (explicitFields.length > 0) {
     return explicitFields
   }
 

packages/node/test/unit/cli/assemblies-create.test.ts

@@ -456,6 +456,55 @@ describe('assemblies create', () => {
     expect(await readFile(outputPath, 'utf8')).toBe('existing-bundle')
   })
 
+  it('reruns single-input bundled assemblies when the input is newer than the output', async () => {
+    vi.spyOn(console, 'error').mockImplementation(() => {})
+
+    const tempDir = await createTempDir('transloadit-bundle-single-input-stale-')
+    const inputPath = path.join(tempDir, 'a.txt')
+    const outputPath = path.join(tempDir, 'bundle.zip')
+
+    await writeFile(inputPath, 'a')
+    await writeFile(outputPath, 'existing-bundle')
+
+    const outputTime = new Date('2026-01-01T00:00:10.000Z')
+    const inputTime = new Date('2026-01-01T00:00:20.000Z')
+
+    await utimes(inputPath, inputTime, inputTime)
+    await utimes(outputPath, outputTime, outputTime)
+
+    const output = new OutputCtl()
+    const client = {
+      createAssembly: vi.fn().mockResolvedValue({ assembly_id: 'assembly-single-input-stale' }),
+      awaitAssemblyCompletion: vi.fn().mockResolvedValue({
+        ok: 'ASSEMBLY_COMPLETED',
+        results: {
+          compressed: [{ url: 'http://downloads.test/bundle-single.zip', name: 'bundle.zip' }],
+        },
+      }),
+    }
+
+    nock('http://downloads.test').get('/bundle-single.zip').reply(200, 'fresh-bundle')
+
+    await create(output, client as never, {
+      inputs: [inputPath],
+      output: outputPath,
+      singleAssembly: true,
+      stepsData: {
+        compressed: {
+          robot: '/file/compress',
+          result: true,
+          use: {
+            steps: [':original'],
+            bundle_steps: true,
+          },
+        },
+      },
+    })
+
+    expect(client.createAssembly).toHaveBeenCalledTimes(1)
+    expect(await readFile(outputPath, 'utf8')).toBe('fresh-bundle')
+  })
+
   it('rewrites existing bundled outputs on single-assembly reruns', async () => {
     vi.spyOn(console, 'error').mockImplementation(() => {})
 

packages/node/test/unit/cli/intents.test.ts

@@ -273,6 +273,24 @@ describe('intent commands', () => {
     expect(createSpy).not.toHaveBeenCalled()
   })
 
+  it('rejects combining --fields labels with --for wordpress', async () => {
+    const { createSpy } = await runIntentCommand([
+      'image',
+      'describe',
+      '--input',
+      'hero.jpg',
+      '--fields',
+      'labels',
+      '--for',
+      'wordpress',
+      '--out',
+      'fields.json',
+    ])
+
+    expect(process.exitCode).toBe(1)
+    expect(createSpy).not.toHaveBeenCalled()
+  })
+
   it('maps image generate flags to /image/generate step parameters', async () => {
     const { createSpy } = await runIntentCommand([
       'image',