mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
c598989d08
The web runtime creates its dev-mode client-hmr row in the root tree after Loader settlement with plain loader.create, deleting the vendored Entry.enableRuntime state machine and dsh-cmdline's enableRow export. Include declares the existing EntryGroup.key tree-carrier marker instead of the EntryConfigResolver protocol (its own path stays literal; nothing used a dynamic path). The launcher recognizes no app row: SIGTERM exits 0 on every surface, every boot watches its user patch layers, and the headless runner exits through ctx.appExit, deleting ctx.headlessIo. Also restores the vendor README rescope entry to the position the rescope-vendor exact-edit anchor requires, fixing the master hygiene regression.
73 lines
4.1 KiB
Markdown
73 lines
4.1 KiB
Markdown
# `@deepseek-ai/dsh-cmdline`
|
|
|
|
English | [中文](README.zh.md)
|
|
|
|
The command line a dsh launcher hands to the app it boots. The launcher parses only its own flags (`--profile`, `--patch`, the config dumps) and hands **everything after them** to the tree verbatim, so an app owns its flag family, its `--help` text, and its parse errors instead of the launcher knowing them.
|
|
|
|
## The launcher values
|
|
|
|
A launcher calls `provideCmdline(ctx, host)` before any tree entry mounts, which provides:
|
|
|
|
- `ctx.cmdlineArgs` — the invocation's inner arguments. `get()` is the whole interface, and it returns a snapshot: `dsh --profile tui --resume abc` yields `['--resume', 'abc']`.
|
|
- `ctx.appExit` — a bounded process-exit request, wired to the launcher's shutdown controller.
|
|
|
|
An embedding host with no command line provides an empty list; that is the honest answer, not a missing value.
|
|
|
|
## Ordinary providers and injected config
|
|
|
|
Any app plugin may inject `cmdlineArgs`, parse it, and publish an ordinary app-owned service. `parseCmdline(ctx, program, plan)` is only a commander adapter; the caller owns the returned value and service:
|
|
|
|
```ts ignore
|
|
export const name = 'web-startup'
|
|
export const inject = ['cmdlineArgs']
|
|
|
|
export function apply(ctx: Context): void {
|
|
const values = parseCmdline(ctx, webCommand(), planWebStartup)
|
|
if (values !== undefined) ctx.provide('webStartup', values)
|
|
}
|
|
```
|
|
|
|
Its Loader row carries no launcher marker or special kind:
|
|
|
|
```yaml
|
|
- id: web-startup
|
|
name: '@deepseek-ai/dsh-web-app/startup'
|
|
```
|
|
|
|
Every row configured from those values uses ordinary service injection and direct lazy config access:
|
|
|
|
```yaml
|
|
- id: webserver
|
|
name: '@deepseek-ai/dsh-host-webserver'
|
|
inject: [webStartup]
|
|
config:
|
|
host: !!js ctx.webStartup.host ?? '127.0.0.1'
|
|
port: !!js ctx.webStartup.port ?? 3080
|
|
```
|
|
|
|
`parseCmdline` parses the immutable arguments and asks `plan` for the app-owned value. On `--help`, `--version`, a parse error, or a `program.error(...)` from the plan, it writes commander's text, requests exit, and returns `undefined`; the provider publishes nothing, so dependent rows never activate.
|
|
|
|
### How injection orders config
|
|
|
|
Loader defers a row's `!!js` interpolation until that row's declared injections are active, then evaluates against the row's plugin context. The example above can therefore read `ctx.webStartup` directly: Cordis has already populated that injected service before Loader asks for `webserver`'s config. Include trees preserve nested expression nodes until each target row reaches this point. Provider replacement and live patch reload repeat interpolation against the current injected services, so a launch flag cannot be silently reset.
|
|
|
|
### Shared immutable arguments
|
|
|
|
`get()` does not consume or mutate argv. Multiple plugins can parse the same snapshot and independently provide services. The launcher does not inspect the composition for a command-line owner; a profile with no reader simply ignores its app arguments.
|
|
|
|
An out-of-tree plugin brings its own commander copy, so commander's control-flow errors are detected structurally rather than by class identity; an identity check would rethrow a printed help as a fatal load failure.
|
|
|
|
## Model Experience
|
|
|
|
None, as this package resolves the process's own command line before any session exists.
|
|
|
|
#### KV Cache effect
|
|
|
|
None; this package neither assembles nor sends a provider request.
|
|
|
|
## Known Limitations and Deferred Work
|
|
|
|
- **Launcher flags must precede app arguments.** The split is positional: the first token the launcher does not recognize starts the inner arguments, so `--patch` placed after an app flag belongs to the app. The launcher's parser consumes one `--`, so an app argument that must survive as a literal `--` needs `-- --`.
|
|
- **An app-owned service has no statically declared provider.** Consumer rows name it through ordinary injection; a bundle that omits its provider fails at settlement with pending entries naming the service rather than at load.
|
|
- **A user patch that replaces a row's whole `config` drops its expressions.** A flag beats the value written beside it, not a literal a user wrote in place of the expression; keeping the expression is what keeps the flag winning.
|