feat(sdk): add developer project tooling

docs(rfc): propose SDK developer project tooling feat: rename / docs ci: fix windows gates docs: revert
2026-07-15 18:17:38 +08:00
parent 5a8466b774
commit 42b07a7022
115 changed files with 11315 additions and 27 deletions
@@ -0,0 +1,70 @@
+/**
+ * Commander adapter for the dsh subcommand surface.
+ *
+ * @module @deepseek-ai/dsh-scripts/args
+ */
+
+import { parseArgs as parseNodeArgs } from 'node:util'
+import { Command } from 'commander'
+
+/** Commands implemented by the dsh launcher. */
+type DshCommand = 'start' | 'dev' | 'build' | 'config'
+
+/** Parsed dsh invocation. */
+export interface DshArgs {
+  command?: DshCommand
+  target?: string
+  forwarded: readonly string[]
+  help: boolean
+}
+
+/** Parse arbitrary project flags through Node's zero-schema argument parser. */
+export function parseSdkBootArgs(argv: readonly string[]): Record<string, string | boolean | undefined> {
+  return parseNodeArgs({
+    args: [...argv],
+    strict: false,
+    allowPositionals: true,
+    allowNegative: true,
+  }).values
+}
+
+/** Parse one launcher invocation through real Commander subcommands. */
+export function parseDshArgs(argv: readonly string[]): DshArgs {
+  if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {
+    return { forwarded: [], help: true }
+  }
+  const separator = argv.indexOf('--')
+  const launcherArgv = separator === -1 ? argv : argv.slice(0, separator)
+  const passthrough = separator === -1 ? [] : argv.slice(separator + 1)
+  let parsed: DshArgs | undefined
+  const program = new Command()
+    .name('dsh')
+    .helpOption(false)
+    .showHelpAfterError(false)
+    .exitOverride()
+    .configureOutput({
+      /* v8 ignore next -- the command wrapper renders the package-owned usage template */
+      writeOut: () => {},
+      /* v8 ignore next -- Commander errors are returned to the command wrapper */
+      writeErr: () => {},
+    })
+  program.command('start [target]').helpOption(false).action((target?: string) => {
+    parsed = { command: 'start', ...target ? { target } : {}, forwarded: [], help: false }
+  })
+  program.command('dev [target]').helpOption(false).action((target?: string) => {
+    parsed = { command: 'dev', ...target ? { target } : {}, forwarded: [], help: false }
+  })
+  program.command('build [args...]').helpOption(false).allowUnknownOption(true).action((args: string[] = []) => {
+    parsed = { command: 'build', forwarded: args, help: false }
+  })
+  program.command('config').helpOption(false).action(() => {
+    parsed = { command: 'config', forwarded: [], help: false }
+  })
+  program.parse([...launcherArgv], { from: 'user' })
+  /* v8 ignore next -- every registered Commander action above assigns parsed or Commander throws */
+  if (!parsed) throw new Error('dsh command did not resolve')
+  if (parsed.command === 'config' && passthrough.length > 0) {
+    throw new Error('dsh config does not accept forwarded arguments')
+  }
+  return { ...parsed, forwarded: [...parsed.forwarded, ...passthrough] }
+}