fraqtal/agentic-dev
Template
1
0
Fork 0
Code Issues Pull Requests Actions 7 Packages Projects Releases Wiki Activity
Files
563eab06a607286ce386e5e4ddbc973043daed96
agentic-dev/docs/work/epics/binder-wrap-helper/02-migrate-feature-binders/_story.md
Danijel Martinek 756e36c720 refactor(work): move epic folders into docs/work/epics/ 
The previous layout placed epic folders directly under docs/work/
alongside prds/ and _system/. Tightening: epics now live in their
own docs/work/epics/ subfolder, peer to prds/ and _system/. Same
shape as the existing prds/ bucket.

Final docs/work/ layout:
  README.md
  prds/<slug>.prd.md
  _system/_state.json
  epics/<slug>/_epic.md + <story-folder>/_story.md

Renames (git mv preserves history):
- docs/work/binder-wrap-helper/
    -> docs/work/epics/binder-wrap-helper/
- docs/work/library-evaluation-policy/
    -> docs/work/epics/library-evaluation-policy/
- docs/work/ci-security-and-supply-chain/
    -> docs/work/epics/ci-security-and-supply-chain/

Tooling updates:
- state-builder.mjs walks workRoot/epics/ directly; SKIP_FOLDERS
  obsoleted (no more sibling folders to filter out).
- dispatch.mjs's findNextTask, tickStoryBulletInEpic, and
  flipEpicDoneIfAllStoriesDone all join with "epics" segment.
- prd-ship.mjs's deriveShippingCommits walks workRoot/epics/ and
  git-logs docs/work/epics/<epic>/.
- decomposer.prompt.md emits epics under docs/work/epics/<epic-id>/.
- handoff + grill-with-docs glossary references updated.
- Glossary entry for Epic updated.

Reserved future shape: when a task-tracker integration (ClickUp,
Linear) ships, the epics/ subfolder hosts <task-id>-<slug>/
folders. Today it just hosts bare slugs.
2026-05-14 21:21:51 +02:00

3.3 KiB
Raw Blame History

id, epic, title, type, status, feature, depends-on, blocks, created, updated
id epic title type status feature depends-on blocks created updated
02-migrate-feature-binders binder-wrap-helper Migrate all five feature binders to wireUseCase technical-story done auth, blog, media, marketing-pages, navigation
01-wire-use-case-helper
2026-05-13T19:17:10+02:00 2026-05-14T19:21:52.308Z

Goal

Replace every inline withSpan + withCapture (+ withAudit) block in each feature's bind-production.ts and bind-dev-seed.ts with a call to wireUseCase. Existing binder-level and integration tests must continue to pass unchanged. Each feature migrates in its own commit.

Why

The five inline wrapping clone groups are the top source of duplication reported by pnpm fallow. Moving to wireUseCase eliminates all five clone groups and leaves each binder as decision content only (which adapter, which mode, which symbol).

Done when

  • All 10 binder files (auth ×2, blog ×2, media ×2, marketing-pages ×2, navigation ×2) call wireUseCase for every use case binding; no inline withSpan + withCapture blocks remain for use cases.
  • assertFeatureConformance at the tail of each bind-production.ts continues to accept all wired use cases (brands present, manifest entries match).
  • pnpm typecheck && pnpm test && pnpm lint && pnpm conformance && pnpm fallow:audit && pnpm coverage:diff pass after each per-feature commit.
  • pnpm fallow dupes no longer shows the five binder-pair clone groups in its output.

In scope

  • packages/auth/src/di/bind-production.ts + bind-dev-seed.ts — 3 use cases (signIn, signUp, signOut).
  • packages/blog/src/di/bind-production.ts + bind-dev-seed.ts — 3 use cases (getArticles, getArticleBySlug, createArticle).
  • packages/media/src/di/bind-production.ts + bind-dev-seed.ts — 3 use cases (getMedia, listMedia, deleteMedia).
  • packages/marketing-pages/src/di/bind-production.ts + bind-dev-seed.ts — 2 use cases (getPageBySlug, getSiteSettings).
  • packages/navigation/src/di/bind-production.ts + bind-dev-seed.ts — 1 use case (getHeader).
  • If any binder's existing tests assert on internal wrapping shape rather than observable behaviour, refactor those assertions to test through the helper's contract (same commit as the binder change).

Out of scope

  • Controller bindings — covered by the helper per the PRD but deferred to a follow-up if scope is a concern.
  • Repository and service bindings — stay as direct .toConstantValue() calls.
  • Apps' bindAll() dispatcher — untouched.

Tasks

  • Migrate auth binders (bind-production.ts + bind-dev-seed.ts) to wireUseCase for all 3 use cases (signIn, signUp, signOut); all gates pass on this commit.
  • Migrate blog binders to wireUseCase for all 3 use cases (getArticles, getArticleBySlug, createArticle); all gates pass on this commit.
  • Migrate media binders to wireUseCase for all 3 use cases (getMedia, listMedia, deleteMedia); all gates pass on this commit.
  • Migrate marketing-pages binders to wireUseCase for both use cases (getPageBySlug, getSiteSettings); all gates pass on this commit.
  • Migrate navigation binders to wireUseCase for the single use case (getHeader); all gates pass on this commit; verify pnpm fallow dupes no longer surfaces the five binder-pair clone groups.