Skip to content

Documented pnpm dev -- --fresh -p <port> is broken: pnpm-forwarded -- is rejected by the oclif dev command #3114

Description

@os-zhuang

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions