Skip to content

phase 3: stronger deprecation notice for run/architect/scaffold/login in charter CLI #126

@stackbilt-admin

Description

@stackbilt-admin

Phase 3 of RFC #112 — surface a stronger runtime deprecation notice in @stackbilt/cli pointing users at @stackbilt/build after it's published.

Context

Scope

On every invocation of charter run, charter architect, charter scaffold, charter login:

  1. Print a warning notice to stderr indicating the command is deprecated and will be removed in Charter 1.0.
  2. Link to @stackbilt/build as the replacement (npm install -g @stackbilt/build).
  3. Notice is pre-execution; command still runs after (no behavior change yet).

Suggested format:

⚠ charter run is deprecated and will be removed in Charter 1.0.
  Install @stackbilt/build for the long-term home of this command:
    npm install -g @stackbilt/build
  See https://github.com/Stackbilt-dev/charter/issues/112 for context.

Acceptance criteria

  • All four deprecated commands print the notice once per invocation before executing.
  • Notice writes to stderr (doesn't pollute stdout for --format json consumers).
  • Notice suppressible via --no-deprecation-warning flag or CHARTER_NO_DEPRECATION_WARNING=1 env var.
  • Tests assert the notice is emitted for each deprecated command.
  • Ships in a minor version bump.

Blocked on

  • Phase 2 (@stackbilt/build must be publishable before the notice can link to a real package).

References

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