nitrojs/nitro `081aa276..476bfcc9`

base and head as given

Task definitions are now scanned from application task directories.
Development servers now expose endpoints for listing and running tasks.
The command line now supports listing and running development tasks.
Task APIs are now available through automatic imports.

files changed: 18
in a component: 15
lines in components: 345
components: 5
public routes changed: 0
schema statements: 0
new dependencies: 0
excluded by role: 3

Where to focus your review

Review the new exported surface2 components with export changes. Check compatibility and intended visibility.
Verify behavior in dependent codeFollow the import paths below and exercise the consumers they reach.
Inspect the paths tracing stopped at1 changed symbol stopped at heavily imported files. Inspect their consumers separately.

Based on 12 of 15 eligible changed files

Development tasks

Added

Before: Tasks did not exist
After: Tasks are scanned and run in development

Projects can define named tasks that Nitro discovers at startup. During development, they can list and invoke those tasks through the command line or task endpoints, with query and request-body data passed as payload.

In favour

In favour: Loads task handlers only when invoked
In favour: Uses one generated registry for task discovery

The model found nothing to weigh against this.

Inspect 12 source files behind this explanation

Files changed in 5 components. Dependencies shown: 1 new, 9 unchanged

unchanged · 9new · 1

1 new dependency between components — Source Files → Runtime Code

What else could behave differently

8 components · 109 files

These components import changed code, directly or through other files. A traced dependency is a place to review, not a confirmed runtime failure. Some paths stopped at heavily imported files; inspect those consumers separately.

Reached 3

Component	Symbol	Cited at	Files	Reached by
Type Definitionssrc/types/	Signature changed `NitroOptions`	src/types/nitro.ts:225-392	2	1 direct · 1 at two steps Trace path Shortest component path from the changed symbol: Type Definitions Later steps follow file imports; they do not prove this symbol is called.
Source Filessrc/	Signature changed `nitroImports`1 of 7 changed symbols reaching it	src/imports.ts:3-25	12	5 direct · 1 at two steps · 6 at three steps Trace path Shortest component path from the changed symbol: Source Files Later steps follow file imports; they do not prove this symbol is called.
src/rollup/	Signature changed `NitroOptions`	src/types/nitro.ts:225-392	10	none direct · 1 at two steps · 7 at three steps · 2 at four steps Trace path Shortest component path from the changed symbol: Type Definitions src/rollup/ Later steps follow file imports; they do not prove this symbol is called.

Held back 2

Component	Files	Reached by	Resolution
src/presets/	34	none direct · 12 at three steps · 22 at four steps	precise
src/utils/	1	none direct · 1 at three steps	precise

Ranked lower 3

Component	Files	Reached by
src/runtime/	42	3 direct · 1 at two steps · 11 at three steps · 27 at four steps
src/dev/	3	1 direct · 2 at three steps
src/cli/	5	5 direct

Not traced past a hub 1

Symbol	Hub file	Imported by
src/nitro.ts:createNitro	src/runtime/app.ts	34

Statements 3

NitroOptions’ signature changed and reached 2 files in src/types/. 11

nitro.ts:225-392

nitroImports’ signature changed and reached 12 files in src/. 516

imports.ts:3-25

NitroOptions’ signature changed and reached 10 files in src/rollup/. 172

nitro.ts:225-392

22 reached files belong to no component — tests, docs and config.

Routes, schema, dependencies

No public URL, no migration and no new package.

Inspect components, files and symbols

Component

Type DefinitionsModified

src/types/

1 file · 3 lines

7 dependents

Source FilesModified

src/

5 files · 146 lines

4 dependents

The public surface added listNitroTasks, runNitroTask, and scanTasks.

Runtime CodeModified

src/runtime/

4 files · 105 lines

2 dependents

The runtime public surface added NitroTask, NitroTaskContext, NitroTaskMeta, NitroTaskPayload, defineNitroTask, runNitroTask, and tasks.

Development ToolsModified

src/dev/

1 file · 6 lines

2 dependents

CLI CommandsModified

src/cli/

4 files · 85 lines

File

Type Definitionssrc/types/

nitro.ts

+2 −1

Source Filessrc/

task.ts

+78 −0

Source Filessrc/

nitro.ts

+52 −2

Source Filessrc/

scan.ts

+11 −0

Source Filessrc/

imports.ts

+2 −0

Source Filessrc/

options.ts

+1 −0

Runtime Codesrc/runtime/

task.ts

+62 −0

Runtime Codesrc/runtime/

entries/nitro-dev.ts

+35 −1

Runtime Codesrc/runtime/

virtual/tasks.ts

+6 −0

Runtime Codesrc/runtime/

index.ts

+1 −0

Development Toolssrc/dev/

server.ts

+3 −3

CLI Commandssrc/cli/

commands/tasks/run.ts

+46 −0

CLI Commandssrc/cli/

commands/tasks/list.ts

+26 −0

CLI Commandssrc/cli/

commands/tasks/index.ts

+12 −0

CLI Commandssrc/cli/

index.ts

+1 −0

Function

imports what changeddownstream of it, one mark per step

createDevServer()server.ts

reaches CLI Commands

createDevServer’s body changed and reached 5 files in src/cli/. 5

server.ts:105-273

createNitro()nitro.ts

reaches nothing past a hub

Analysis stopped tracing createNitro’s body change through src/runtime/app.ts at 3 hops because it has 34 importers.

nitro.ts:18-188

NitroTask()task.ts

reaches Runtime Code

NitroTask was added and reached 42 files in src/runtime/. 311127

task.ts:20-25

NitroBuildInfo()nitro.ts

reaches Development Tools

NitroBuildInfo’s signature changed and reached 3 files in src/dev/. 12

nitro.ts:207-223

NitroOptions()nitro.ts

reaches 2 components

NitroOptions’ signature changed and reached 34 files in src/presets/. 1222

nitro.ts:225-392

NitroOptions’ signature changed and reached 1 file in src/utils/. 1

nitro.ts:225-392

Diff

Type Definitionssrc/types/

nitro.ts

221–221, 299–299

Source Filessrc/

task.ts

1–78

Source Filessrc/

nitro.ts

2–2, 14–14, 110–159

Source Filessrc/

scan.ts

82–92

Source Filessrc/

imports.ts

20–21

Source Filessrc/

options.ts

57–57

Runtime Codesrc/runtime/

task.ts

1–62

Runtime Codesrc/runtime/

entries/nitro-dev.ts

8–14, 17–18, 52–77

Runtime Codesrc/runtime/

virtual/tasks.ts

1–6

Runtime Codesrc/runtime/

index.ts

5–5

Development Toolssrc/dev/

server.ts

28–28, 100–100, 213–213

CLI Commandssrc/cli/

commands/tasks/run.ts

1–46

CLI Commandssrc/cli/

commands/tasks/list.ts

1–26

CLI Commandssrc/cli/

commands/tasks/index.ts

1–12

CLI Commandssrc/cli/

index.ts

15–15

Analysis scope

427 → 5

427
files at head
12
components
5
changed by this change

Where the new files landed

6 new files

New file	Belongs to	Used by	Calls	Serves
src/task.ts	Source Filesbase frame	CLI Commands	Runtime Code	—
src/runtime/2 new files	Runtime Codebase frame	Source Files	nothing outside its own component	—
src/cli/3 new filesnothing outside src/cli/commands/tasks/ imports any of it	CLI Commandsbase frame	nothing in the existing application	Source Files	—

2 added files carry no component — 2 test.

5components changed

3reached, not changed

0components added/removed

1dependencies added between components

0dependencies removed between components

0files moved to another path

18 files changed, 16 claims stated. 8 components reached in total.