Skip to content

phase 2: stand up @stackbilt/build in new Stackbilt-dev/stackbilt-build repo #125

@stackbilt-admin

Description

@stackbilt-admin

Phase 2 of RFC #112 — relocate the commercial CLI surface (run, architect, scaffold, login) from @stackbilt/cli into a new @stackbilt/build npm package housed in a new GitHub repo.

Context

Scope

  1. Create the repo Stackbilt-dev/stackbilt-build (public, Apache-2.0).
  2. Port files from @stackbilt/cli:
    • packages/cli/src/commands/{login,architect,run,scaffold}.ts
    • packages/cli/src/credentials.ts, http-client.ts
    • packages/cli/src/types/scaffold-contract-types.ts (vendored)
    • Tests: credentials.test.ts, login.test.ts, auth-wiring.test.ts
  3. Package naming: @stackbilt/build on npm, stackbilt bin alias.
  4. Replicate release infra: charter's release.yml with npm trusted-publisher OIDC (see ci(release): publish to npm on tag push #118 through ci(release): upgrade npm to 11+ for trusted-publisher OIDC auth #121 for the full end-state pattern; notably: npm 11+ upgrade step, no registry-url, no NODE_AUTH_TOKEN).
  5. Configure npm trusted publishers on @stackbilt/build before first publish.
  6. Initial version: resolve Open Q feat(setup): add docs/planning preset for non-code workspaces (ADX-006) #3 (start at 0.1.0 vs. match charter's current minor) before first publish.
  7. New repo README: reclaim the stackbilt run hero + scaffolding visuals that were removed from charter in docs: lead README with governance; remove build-hero + images #124.

Acceptance criteria

  • Stackbilt-dev/stackbilt-build repo exists, public, Apache-2.0.
  • @stackbilt/build on npm at initial version, installable globally.
  • stackbilt run "..." end-to-end against the engine, installed via the new package.
  • All tests pass in new repo's CI.
  • Release workflow uses OIDC trusted-publisher auth. Provenance attestations attached to published tarballs.

Out of scope (tracked separately)

  • Phase 3 — stronger CLI deprecation notice in charter.
  • Phase 4 — full removal of the 4 commands from @stackbilt/cli at Charter 1.0.

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    v1.0Targeted for Charter v1.0

    Type

    No type
    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