T-V57A-books-consolidation-p3-packages

Status: open/ready · Impact: medium · Complexity: small

Goal

Complete the books solution: move the two book libraries out of the augmented staging solution into solutions/augmented_learning/packages/ts/. Package NAMES don’t change (@augmented/books, @augmented/hierarchy), so imports are untouched; workspace/moon globs cover the new paths.

Today

Location	Role today
`solutions/augmented/packages/ts/books/`	`@augmented/books` — Model B (books_v2) service; consumed by learn_web (now at `solutions/augmented_learning/apps/learn_web/` post-`T-SRJQ`)
`solutions/augmented/packages/ts/hierarchy/`	`@augmented/hierarchy` — Model A parser; integration tests bind content via `@augmented/books-content` (post-`T-PP4I`)
`solutions/augmented_learning/apps/learn_web/package.json`	Its `dev` script watches a dead path (`../../packages/node/hierarchy/dist` — `packages/node/` never existed here); correct target exists only after this move
`.gitignore`	`solutions//packages/ts//dist/` — wildcarded, covers the new paths

Proposed

solutions/augmented_learning/packages/ts/{books,hierarchy}/ exist; old paths gone; only bun.lock regenerates at root. learn_web’s dev watch path points at ../../packages/ts/hierarchy/dist.

Approach

git mv solutions/augmented/packages/ts/books solutions/augmented_learning/packages/ts/books and …/hierarchy → solutions/augmented_learning/packages/ts/hierarchy.
Fix learn_web’s dev script watch path: ../../packages/node/hierarchy/dist → ../../packages/ts/hierarchy/dist.
Root bun.lock: bun install; verify --frozen-lockfile. No other root edits (globs cover; moon ids books/hierarchy unchanged).
Verify: moon run books:build && moon run hierarchy:build; bun run test in both moved packages (books fixtures are __dirname-relative — move-safe; hierarchy integration is resolver-based); learn_web bun run build + prod smoke.
Capture three backlog entries via sdlc backlog create (if not already present): (a) promote-or-fold the cross-solution deps left behind in solutions/augmented/packages/ts/ (@augmented/{entity,context,logging,utils,test-vue-component}) per the D-0001 tier-0→1 gate; (b) purge books_v2 editor-scratch books; (c) purge Model A flat remnants.

Files to touch

Location	Kind	Change
`solutions/augmented/packages/ts/books/`	delete	`git mv` → `solutions/augmented_learning/packages/ts/books/`
`solutions/augmented/packages/ts/hierarchy/`	delete	`git mv` → `solutions/augmented_learning/packages/ts/hierarchy/`
`solutions/augmented_learning/packages/ts/`	new	Destination (books-content already lives here)
`solutions/augmented_learning/apps/learn_web/package.json`	modify	Fix dead dev-watch path
`bun.lock`	modify	Workspace path-key regen
`docs/planning/backlog/`	modify	Three captures (promotion, scratch purge, remnant purge) via `sdlc backlog create`

Acceptance criteria

AC-1: Both packages build and test green at the new paths (moon run books:build hierarchy:build; bun run test each).
AC-2: learn_web bun run build succeeds; prod smoke from repo root answers /api/books/v2.
AC-3: bun install --frozen-lockfile passes at root.
AC-4: No solutions/augmented/packages/ts/(books|hierarchy) references remain outside historical planning entities.
AC-5: The three backlog entries exist with B-ids listed in the PR body.

Out of scope

Executing the promotion/fold of the remaining @augmented/* packages (backlog-gated).
Format convergence (one book model) — separate backlog item.

Dependencies

T-SRJQ — apps must be at solutions/augmented_learning/apps/ so the watch-path fix and grep-proofs land coherently.

Discovery context

Phase 3 of the books consolidation (owner decision 2026-08-01); plan file ~/.claude/plans/twinkly-meandering-rabbit.md.

Depends on

T-SRJQ

← Back to Tasks