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

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions