T-WORD-augmented-web-build-broken
Status: closed/done · Impact: low · Complexity: small
augmented_web cannot build from a fresh checkout, twice over: its dep
@augmented/utils publishes through gitignored dist/ (absent until a
manual tsc), and with that built, the app’s client bundle still fails on
node:fs/promises inside utils/fs.js. Decide whether the app is worth
fixing or should fold into the augmented dissolution, and make main honest
either way.
| Location | Role today |
|---|---|
solutions/augmented/apps/augmented_web/ | nuxt build fails: first on missing @augmented/utils dist, then on node:fs in the browser bundle |
solutions/augmented/packages/ts/utils/ | Dist-published (exports → dist/, gitignored); mixes browser-safe helpers with Node-only fs utilities in one entry |
Proposed
Section titled “Proposed”Either the app builds from a pristine checkout (utils source-shipped per the
@sksizer/panes pattern, Node-only helpers split out of the browser entry),
or the app is retired as part of the dissolution and the broken build stops
pretending to be a target.
Approach
Section titled “Approach”- Decide with the dissolution direction (
T-OO89moves this app tosites/): fix-in-place or retire. - If fixing: source-ship
@augmented/utils; splitutils/fsbehind a./nodesubpath so the browser entry has no Node imports. - If retiring: fold into the dissolution task and delete.
Files to touch
Section titled “Files to touch”| Location | Kind | Change |
|---|---|---|
solutions/augmented/packages/ts/utils/package.json | modify | Source-shipped exports; Node-only subpath (fix branch) |
solutions/augmented/apps/augmented_web/ | modify | Import updates, or removal (retire branch) |
Acceptance criteria
Section titled “Acceptance criteria”- AC-1: On a pristine checkout, either
augmented_webbuilds with no manual dist step, or the app no longer exists as a build target.
Out of scope
Section titled “Out of scope”- The determined products’
markdown-contractfailure (T-S0TW) — a different root in the same sweep.
Dependencies
Section titled “Dependencies”T-OO89— the retire-vs-fix call belongs to the dissolution sequencing.
Discovery context
Section titled “Discovery context”- Surfaced verifying T-ZLS5 AC-3 during the json-canvas promotion (#1308): name-based resolution of the moved packages held, but the app itself was found already unbuildable on pristine main.