repo-adapter-api:adapter-outputs

`repo-adapter-api:adapter-outputs@0.0.0`

`AdapterCommandInvocation`

Field	Type	Required	Default	Description
`program`	`string`	Yes		The shell the host started to run the command, by its executable's file name without a directory
`args`	`list[string]`	No	`[]`	The arguments the shell was started with, in order: its own flags, then the command line it was given to run

`AdapterCommandDescriptor`

Field	Type	Required	Default	Description
`executable`	`string`	Yes		The program the adapter asked the host to run, as the adapter named it
`args`	`list[string]`	No	`[]`	The arguments the adapter asked for it to be run with, in order

`AdapterCommandExecution`

Field	Type	Required	Default	Description
`adapter`	`string`	Yes		The shell adapter that ran the command, by name: the shell the host is configured to run commands through
`command`	`string`	Yes		The command line the shell was given: the program and its arguments, quoted as that shell reads them
`invocation`	`AdapterCommandInvocation`	Yes		The process the host started to run it: the shell's executable and the arguments it was started with
`exitCode`	`integer`	Yes		The exit code the process ended with; `0` is success
`stdout`	`string`	Yes		What the command wrote to standard output, cut to its tail where it is longer than a response field holds. Empty where the output was streamed to the terminal as it ran and not captured.
`stderr`	`string`	Yes		What the command wrote to standard error, cut to its tail where it is longer than a response field holds. Empty where the output was streamed to the terminal as it ran and not captured.

`AdapterExecutionSummary`

Field	Type	Required	Default	Description
`stdout`	`string`	Yes		The standard output of every command that ran, in the order they ran, joined by newlines and cut to its tail where it is longer than a response field holds. Empty where the output was streamed and not captured.
`stderr`	`string`	Yes		The standard error of every command that ran, in the order they ran, joined by newlines and cut to its tail where it is longer than a response field holds. Empty where the output was streamed and not captured.
`exitCode`	`integer`	Yes		The exit code of the first command that failed, after which no later one is run, or `0` where every command passed or there was nothing to run
`durationMs`	`integer`	No		How long the run took, in whole milliseconds, where the command reporting it timed one: every repository it crossed into included, since a recursive run is one run. Absent where nothing timed it
`commands`	`list[AdapterCommandDescriptor]`	No	`[]`	Every command the adapter asked for, in the order it asked, whether or not the run reached it. Empty where there was nothing to run.

`AdapterResult`

Field	Type	Required	Default	Description
`adapter`	`AdapterExecutionSummary`	Yes		The run as a whole: the commands the adapter asked for, their combined output and the exit code the run ended with
`adapterResults`	`list[AdapterCommandExecution]`	No	`[]`	One record for each command that was started, in the order they ran, ending at the first that failed. Empty where no command ran, which is how a run that had nothing to do is told from one that did something.

`AdapterUnavailable`

Field	Type	Required	Default	Description
`message`	`string`	No	`"Repo adapter command is unavailable for the selected modules/repo adapters."`	Why nothing ran: which command no repo adapter of the selected modules implements

`PackagedFile`

Field	Type	Required	Default	Description
`source`	`path`	Yes		Where the file is on disk when the application is packaged
`destination`	`string`	Yes		The directory the application looks for the file in once it is running, written with forward slashes and counted from the directory the code reading it is imported from, which is not the repository root where packages sit under a directory of their own

`PackagingInputs`

Field	Type	Required	Default	Description
`modulesLoadedByName`	`list[string]`	No	`[]`	Modules the application loads by name at run time, which no import statement names
`packagesLoadedByName`	`list[string]`	No	`[]`	Packages whose every module, at any depth, is loaded by name at run time: discovered rather than imported
`files`	`list[PackagedFile]`	No	`[]`	Files the application reads after it has started, and where it looks for each
`excludedPackages`	`list[string]`	No	`[]`	Packages that are not part of the application: nothing in or beneath one belongs in the artifact, whatever import or entry above reaches it
`obtainedPackageRoots`	`list[path]`	No	`[]`	Directories the application's obtained packages are imported from: code that is part of the application and was fetched into the tree rather than written or installed there, so nothing a packager already searches leads to it

`VendoredRequirementsFile`

Field	Type	Required	Default	Description
`path`	`path`	Yes		Where the file goes, relative to the consuming repository root
`content`	`string`	Yes		What the file holds, rendered whole

`AdapterOutput`

One of the types AdapterResult, AdapterUnavailable.