Skip to content

Phase 0: Toolchain & Style Gate (scaffold milestone) #1

Description

@Wahbeh-Mohammad

Bootstrap the repository from docs-only to a buildable, lintable, testable, dual-consumable workspace with zero
domain code
, so every later phase is written under the quality gates from line one.

Scope

  • Bun workspace scaffolding: packages/*, Bun workspaces, .bun-version pin, bun.lock.
  • One stub package @dexpace/core with a trivial placeholder export — enough surface to exercise every gate.
  • Full toolchain/CI gate list wired and blocking: tsc build (library packages build with tsc, never
    Bun.build), lint, bun test + coverage floor, api-extractor report, changesets.
  • Verify the built package is consumable from both TypeScript and plain JavaScript (ESM JS + .d.ts).

Out of scope: every other package, all domain code, the appendix-B conformance harness (Phase 9).

Spec refs

Product spec: — (no normative IDs). sdk-design: §2, §9.

Dependencies

None — first phase.

Docs

  • Design: docs/superpowers/specs/2026-07-23-scaffold-milestone-design.md
  • Plan: docs/superpowers/plans/2026-07-23-scaffold-milestone.md
  • Checklist: docs/superpowers/plans/2026-07-23-scaffold-milestone-checklist.md

Notes

Package manager and test runner are Bun, not pnpm — the styleguide overrides sdk-design-nodejs/02's pnpm
mechanics; the multi-package workspace layout still holds. Several NFR-* items are deliberately deferred out of
this phase (NFR-2, NFR-14, peer-dep dedup → 6a; NFR-9 → 9; NFR-12/NFR-16 → first real release).

Metadata

Metadata

Labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions