Turtle
4eb26f0e71
* feat(cli): dump native Cordis config schemas * test(cli): include schema dump in launcher help snapshot * feat(cli): export JSON Schema for Cordis configuration * fix(cli): preserve config schema discovery and annotations * fix(cli): conservatively project effectful config validation * refactor(boot): encapsulate profile config schema generation * fix(cli): follow Loader disabling and native writeback in config schema - Dormant group/include rows (disabled without group: true) may omit config and are recorded as childless trees; the entry schema skips their child declarations, matching the Loader, which never creates them. - Lazy builders run once per document, and a wrapped null-only projection keeps a deduplicated type list so the document stays compilable. - Union widening applies only when an earlier branch can write adapted values back through a container; +Infinity max and -Infinity min without a step are treated as the native no-ops they are. - Projection limitations repeat at every entry sharing a Config, and the entry schema documents the boolean/expression domain of disabled. - Record the schema-dump validation policy as an Agent Note.
77 lines
2.8 KiB
TypeScript
77 lines
2.8 KiB
TypeScript
/**
|
|
* Config-dump entry for `dsh --profile <name> --dump-config`: compose the
|
|
* profile's patch layers through the include plugin's patch algorithm without
|
|
* booting or evaluating `!!js`, with one source layer per bundle, the
|
|
* profile's own patch file, and each `--patch` overlay.
|
|
* @module @deepseek-ai/dsh/dump-config
|
|
*/
|
|
|
|
import { existsSync } from 'node:fs'
|
|
import { join, resolve } from 'node:path'
|
|
import {
|
|
loadOptionalPatches,
|
|
loadOverlayPatches,
|
|
renderConfigDump,
|
|
type ConfigDumpLayer,
|
|
type Profile,
|
|
} from '@deepseek-ai/dsh-app-boot'
|
|
import { homePatchPath, prepareProfile, PROFILE_ROOT_FILENAME } from './profile-boot.ts'
|
|
|
|
const NAME = 'dsh'
|
|
|
|
/* v8 ignore start -- built-bin acceptance drives this boot-free dispatch */
|
|
/**
|
|
* Print a profile composition with comments naming each source file and patch layer.
|
|
* @param profile - the profile name.
|
|
* @param defaultOnly - omit the profile's user layer and `--patch` overlays
|
|
* (the recovery diagnostic for a broken `cordis.patch.yml`, which is then
|
|
* never parsed).
|
|
* @param patches - `--patch` overlay paths, in argv order.
|
|
* @param fromDefaultProfile - shipped template used once to initialize a missing profile.
|
|
*/
|
|
export function runDumpConfig(
|
|
profile: string,
|
|
defaultOnly: boolean,
|
|
patches: readonly string[],
|
|
fromDefaultProfile?: string,
|
|
): void {
|
|
const loaded = prepareProfile(profile, !defaultOnly, fromDefaultProfile)
|
|
const layers = collectConfigDumpLayers(loaded, defaultOnly, patches)
|
|
// The dump anchors on the same empty root file the boot includes.
|
|
process.stdout.write(renderConfigDump(NAME, join(loaded.dir, PROFILE_ROOT_FILENAME), layers))
|
|
}
|
|
|
|
/**
|
|
* Read dump layers in bundle, profile, home, then argv order without composing them.
|
|
* @param loaded - prepared profile and parsed bundle and profile patches.
|
|
* @param defaultOnly - omit profile, home, and argv layers without reading their files.
|
|
* @param patches - overlay paths relative to the invoking directory, in argv order.
|
|
* @returns the labeled layers shared by YAML and schema dumps.
|
|
*/
|
|
export function collectConfigDumpLayers(
|
|
loaded: Profile,
|
|
defaultOnly: boolean,
|
|
patches: readonly string[],
|
|
): ConfigDumpLayer[] {
|
|
const layers: ConfigDumpLayer[] = loaded.layers.map(layer => ({
|
|
label: layer.packageName,
|
|
patches: layer.patches,
|
|
}))
|
|
if (!defaultOnly) {
|
|
if (existsSync(loaded.patchPath)) {
|
|
layers.push({ label: loaded.patchPath, patches: loaded.patches })
|
|
}
|
|
const homePatchFile = homePatchPath()
|
|
const homePatches = loadOptionalPatches(NAME, homePatchFile)
|
|
if (homePatches !== undefined) {
|
|
layers.push({ label: homePatchFile, patches: homePatches })
|
|
}
|
|
for (const file of patches) {
|
|
const absolute = resolve(file)
|
|
layers.push({ label: absolute, patches: loadOverlayPatches(NAME, absolute) })
|
|
}
|
|
}
|
|
return layers
|
|
}
|
|
/* v8 ignore stop */
|