Symptom
The AGENTS.md-documented backend-debug flow fails at the repo root (pnpm 10.31.0):
$ pnpm dev -- --fresh -p 44637
…
ERR_PNPM_RECURSIVE_RUN_FIRST_FAIL @objectstack/example-showcase@0.3.11 dev: `objectstack dev --seed-admin -- --fresh -p 44637`
Exit status 2 # oclif prints the dev command's help
Root dev script is pnpm check:console-sha && pnpm --filter @objectstack/example-showcase dev; the filtered run forwards extra args with a literal -- separator, and the oclif dev command (strict parsing, no positionals) rejects -- --fresh -p 44637 as unexpected arguments and exits 2.
Workaround
Run the bin directly in the example dir: cd examples/app-showcase && ./node_modules/.bin/objectstack dev --seed-admin --fresh -p <port>.
Fix options
- Teach the oclif commands to accept a leading
-- end-of-flags separator (POSIX convention; oclif supports '--': true passthrough), or
- change the root
dev/dev:crm scripts so forwarding survives the pnpm-filter hop, and
- re-verify the AGENTS.md “Backend-only debug” row actually works as written (it is the canonical multi-agent flow, so every agent following the doc hits this).
Found while smoke-testing the NO_COLOR logger fix (#3111) — not addressed there.
Symptom
The AGENTS.md-documented backend-debug flow fails at the repo root (pnpm 10.31.0):
Root
devscript ispnpm check:console-sha && pnpm --filter @objectstack/example-showcase dev; the filtered run forwards extra args with a literal--separator, and the oclifdevcommand (strict parsing, no positionals) rejects-- --fresh -p 44637as unexpected arguments and exits 2.Workaround
Run the bin directly in the example dir:
cd examples/app-showcase && ./node_modules/.bin/objectstack dev --seed-admin --fresh -p <port>.Fix options
--end-of-flags separator (POSIX convention; oclif supports'--': truepassthrough), ordev/dev:crmscripts so forwarding survives the pnpm-filter hop, andFound while smoke-testing the NO_COLOR logger fix (#3111) — not addressed there.