Phase — Exports (combined)
Status: Completed — public @zamdevio/i18nprune/core surface, CLI --json contract, and programmatic run* helpers are shipped. Hub: active-phase.md.
This folder holds planning and history for the exports / JSON / core surface. Normative user docs live under docs/json/README.md, docs/json/programmatic.md, and docs/exports/.
What shipped (single checklist)
- Command-orchestrator boundary (commands phase + ADR 006).
- Namespaced
corefacade + flat re-exports (packages/cli/src/exports/core.ts,exports/namespaces/*). - Stable vs Advanced classification (exports/core.md).
- CLI JSON envelope
{ ok, kind, data, issues, meta }for allCOMMANDS_WITH_JSON_OUTPUT(json/README.md). -
issues[]+ issue-code registry (issue codes). - Programmatic
tryResolveContext,stringifyEnvelope,run*for envelope commands (programmatic.md). - Types: envelope in
packages/cli/src/types/core/json/envelope.ts; command payloads undertypes/command/*/json.tswhere applicable.
Companion notes (same phase)
| Doc | Focus |
|---|---|
| api-surface.md | Namespaces, semver tiers, run* naming |
| docs-sync.md | Keeping docs/ and the Nextra app in sync |
| apps-detach-foundation-alignment.md | Monorepo layout vs original plan |
Residual ideas (not tracked here)
Optional later work (product decision): richer summary footer lines with issues[], or extra alignment between global --report-file and stdout envelopes. File an issue or a new phase when scope is concrete.
Execution order (historical)
- Lock command-orchestrator boundary.
- Namespaced public API in
packages/cli/src/exports/*. - Stable vs advanced classification in
docs/exports/core.md. - Align CLI JSON with typed
datapayloads + envelope. - Single JSON spec:
docs/json/README.md; programmatic pointers indocs/json/programmatic.md.