create-wakii-stack 0.0.0-stage → 0.1.1

package/stack-template/docs/superpowers/improvements-log.md

@@ -0,0 +1,158 @@
+# Improvements Log (Principle 6 — flag, KHÔNG tự sửa skill)
+
+| Date | Task | What | Where | Suggested change |
+|------|------|------|-------|------------------|
+| 2026-10-12 | FI-71 (SF-3) | `story-plan-validate` W1 báo "spec không có tiêu chí nghiệm thu" dù task spec có dòng `Exit: …` — keyword grep không khớp format "Exit:" | ~/.claude/bin/story-plan-validate | Thêm pattern `Exit:`/`tiêu chí` vào detector W1 |
+| 2026-10-12 | FI-71 (SF-3) | orca CLI rất chậm (~10-15s/call) — batch task-create 9 task vượt timeout 120s phải chạy background; task-update tương tự | orca orchestration | Không phải skill bug — ghi nhận để batch lệnh orca vào 1 lệnh background từ đầu |
+| 2026-10-12 | FI-71 (SF-3) | Gotcha TDD-in-CI: dev machine không JDK/Docker → `tdd: RED→GREEN` bất khả thi; convention B1+ nên có dạng `tdd: skipped-tdd: CI-only <reason>` chuẩn hoá | post-task-ritual / kit evidence convention | Ghi shape evidence cho CI-only runs |
+| 2026-10-12 | FI-71 (SF-3) | openapi-generator `interfaceOnly` KHÔNG gắn class-level base path — implementor phải tự thêm `@RequestMapping("${openapi.<svc>API.base-path:/api/<svc>}")` (root cause 1 vòng CI) | SF-2 node-svc (nếu dùng pattern tương tự), kit patterns | Ghi pattern vào conventions hoặc plan template cho service codegen sau |
+
+## 2026-10-12 — SF-2 node-svc (FI-70)
+- [p6-flag] `.github/workflow-templates/services-ci.yml.example` (SF-1 sở hữu): pnpm/action-setup@v4 fail ERR_PNPM_BAD_PM_VERSION khi workflow khai `version:` trùng với `packageManager` trong package.json — nên comment hướng dẫn bỏ `version` khi repo đã pin packageManager. Gặp ở run 38227939477.
+- [p6-flag] conventions/01-dockerfile-pattern.md: pattern `COPY pnpm-lock.yaml` bất khả thi cho workspace member (build context = thư mục con, root lockfile ngoài context) — cần thêm variant "local standalone lockfile" (auth-mock precedent). Đã fix trong services/node-svc (spec D2), conventions cần sync ở SF-7.
+- [p6-flag] drizzle-orm migrator (node-postgres, 0.44) luôn phát `CREATE SCHEMA IF NOT EXISTS "<migrationsSchema>"` — cần CREATE trên DATABASE, không chỉ schema → với per-service DB role (grant schema-only) boot crash. Pattern fix: custom SQL runner skip CREATE SCHEMA khi to_regnamespace tồn tại (services/node-svc/src/db/migrate.ts). Nên thành ADR/knowledge cho SF-3 (Flyway không vấn đề này nhưng Spring Boot role-only grant tương tự).
+- [p6-flag] CI log-dump step gọi lại `docker compose` phải truyền cùng `--env-file` nếu không interpolation fail che mất log thật (run 38228924847). services-ci.yml.example nên note.
+- [p6-flag] Fastify v5: pino ≥9.14 `Logger` type không gán được vào `loggerInstance` (thiếu msgPrefix) — cast qua FastifyBaseLogger; HttpError phải expose field `statusCode` (không phải `status`) để error handler đọc. P2 chờ: additionalProperties:false chặt hơn contract OpenAPI mặc định — cần quyết chung cho 3 service (FE decodeErrorEnvelope phụ thuộc code catalog).
+
+## 2026-10-12 — SF-4 go-svc (FI-72)
+
+1. **story-plan-validate crash cp1252** — `~/.claude/bin/story-verify` và `story-plan-validate` crash `UnicodeEncodeError` khi task spec chứa tiếng Việt trên Windows (PYTHONIOENCODING=utf-8 workaround được). Suggested: script set `sys.stdout.reconfigure(encoding='utf-8')` sẵn. (bin: story-plan-validate, story-verify)
+2. **orca orchestration task-create rapid-fire fail** — 9 task-create gọi liên tiếp không sleep → tất cả fail `ok:false` không 'result' (mutation lock/rate?). Suggested: skill hướng dẫn pacing ≥3-4s giữa các mutation call hoặc batch API. (skill: orca-superpowers-workflow Phase 3 DAG wiring)
+3. **story-verify B4 vs SF checklist "KHÔNG merge"** — B4 check "HEAD là ancestor của story dest" nhưng SF executor bị cấm merge (brief bước 3) → B4 luôn FAIL ở executor handoff; "sạch" chỉ đạt được sau khi story-hub merge. Suggested: story-verify thêm flag `--executor-view` (B4 report PENDING-MERGE thay vì FAIL khi SF chưa report merged). (bin: story-verify)
+4. **schemathesis + healthcheck paths** — spec OpenAPI khai /healthz+/readyz dưới servers.url prefix nhưng conventions quy định naked path → schemathesis 404. Auth-mock precedent = mirror cả hai dạng; SF-4 phải tự discover điều này (tốn 1 vòng CI). Suggested: conventions/02 ghi rõ mirror rule cho MỌI service mới. (doc: platform/conventions/02-healthcheck.md — SF-1 sở hữu, flag lên coordinator)
+5. **CREATE SCHEMA IF NOT EXISTS permission-denied** — role có CREATE trên schema nhưng không có CREATE trên database → CREATE SCHEMA IF NOT EXISTS vẫn denied dù schema tồn tại. Canonical DDL nên tách CREATE SCHEMA khỏi phần table (hoặc note cho CI apply-as-role). (doc: contracts/db/tasks-schema.sql — SF-1 sở hữu)
+
+## 2026-10-12 — SF-5 (FI-73) run
+- **orca CLI id-capture gotcha (lặp lại FI-459 class)**: `run-create` trả top-level `id` = request id, run thật ở `.result.run.id` (format `run_*`); `gate-create` tương tự (`.result.gate.id`). task-create chấp nhận `--run <uuid-không-tồn-tại>` âm thầm → 9 tasks orphan trong run invisible. Suggested: task-create nên validate run id tồn tại; skill nên có helper capture id qua `.result.*` path thay vì grep-first-id. (learned-date 2026-10-12)
+- **task-update status vocabulary**: `done` không hợp lệ — phải là `completed` (pending/ready/dispatched/completed/failed/blocked). Suggested: ghi rõ trong SKILL.md Phase 4 examples. (learned-date 2026-10-12)
+- **story-plan-validate encode lỗi trên Windows**: cần `PYTHONIOENCODING=utf-8` khi output có tiếng Việt (cp1252 UnicodeEncodeError). Suggested: set trong script itself. (learned-date 2026-10-12)
+
+## 2026-10-12 — SF-6 FE remotes (FI-74)
+- **fe-shared loadRemoteModule defect** (mf-bootstrap.ts): native `import()` với specifier BIẾN không được bundler rewrite; runtime API `loadRemote` cần key không có './' prefix. Bug tiềm ẩn suốt SF-1/SF-5 vì chỉ test remote-DOWN. Suggested change: SF-1 thêm unit characterization test + ghi pattern vào fe-shared README. (Đã fix + FLAG, commit c81309d.)
+- **pnpm `catalog:` literal rò vào mf-enhanced requiredVersion** — singleton remote nên khai `requiredVersion: false` tường minh. Suggested: conventions/08 thêm 1 dòng.
+- **story-guard-secrets hook**: chặn inline `JWT_SECRET=...` kể cả khi có WAKII_GUARD_OFF=1 inline — cần export qua script file. Suggested: hook tôn trọng WAKII_GUARD_OFF inline hoặc docs ghi rõ cách override.
+- **evidence hash gate (B1)**: test-run.txt phải ghi HEAD tại lúc ghi (hash đổi sau commit mới → B1 flip FAIL). Suggested: story-verify chấp nhận docs-only commit sau evidence hash.
+
+## 2026-10-13 — SF-7 convergence (FI-75)
+- **GitHub Actions YAML block-scalar gotchas (3 vòng CI đỡ được nếu biết)**: (1) `name:` chứa `": "` trong ngoặc → YAML parse error, phải quote; (2) heredoc terminator/JSON ở cột 0 bên trong `run: |` block PHÁ block scalar (scalar đòi indent > key) — dùng CLI flags hoặc `printf` thay heredoc trong workflow; (3) sửa step trong block scalar dễ xoá nhầm `mkdir` đường dẫn của step trước (regression run 38289733584 — copy-dir chết 6s).
+- **pnpm `catalog:` + standalone copy**: `--ignore-workspace` tắt luôn catalog (workspace feature) → ERR_PNPM_CATALOG_ENTRY_NOT_FOUND dù đã copy pnpm-workspace.yaml. Fix: mini workspace (catalog block) + `pnpm install` KHÔNG ignore-workspace. Pattern: `sed -n '/^catalog:/,$p' root-workspace > tmp/pnpm-workspace.yaml` (giả định catalog là section cuối — đúng hiện tại).
+- **Repo-con standalone test đọc repo-relative contracts** (node-svc schema-diff.test resolve 4 cấp lên): copy-dir job phải kèm đúng cấu trúc thư mục mà test resolve tới. FLAG SF-2: README node-svc mục standalone nên ghi dependency `contracts/db/tasks-schema.sql`.
+- **[p6-flag] orca CLI PATH/class FI-459 lần 3**: script bash gọi orca phải set PATH MSYS-style + gọi `orca.cmd` absolute; `python` capture id fail âm thầm → deps rỗng → task-create im lặng rơi ra khỏi run. Suggested: helper script chuẩn hoá (bin: story-* hoặc kit).
+- **[p6-flag] story-verify + story-plan-validate cần python3**: Windows không có python3 (chỉ python.exe 3.12) → B3 UNKNOWN nếu không shim. Suggested: script dùng `python` fallback hoặc tự shim (bin: story-verify, story-plan-validate — trùng finding SF-4 #1, chưa fix).
+- **MINI-RITUAL tổng (T1-T10)**: patterns → improvements-log (mục này) + ADR 0003 gotcha codegen + conventions/01|02|08 sync; compose env bug → DONE report (SF-1 fix trên dest); no-new-patterns cho ADR/docs tasks.
+
+## 2026-10-13 — SF-1 FI-77 (kafka foundation)
+- **Bash chết giữa phiên (msys add_item errno 1, 9 lần liên tiếp)**: work-around hiệu quả — dồn toàn bộ file-work (Write/Edit) lên trước, đặt cron session-only retry 4 phút, tự tiếp tục checklist khi bash sống lại. 0 work mất. Suggested change: orca-superpowers-workflow thêm 1 mục "environment blocker handling" vào rollback-ritual.md (bash-down playbook: file-first + cron retry + báo user với hướng unblock cụ thể).
+- **Reviewer P1 trên commit pre-existing của session khác trong range diff**: c708e20 (.claude/settings.json) nằm trong range `base..HEAD` dù SF-1 không đụng. Resolved bằng ABSORB + commit-chronology evidence (timestamp + parent) thay vì revert. Suggested change: code-reviewer agent brief nên ghi rõ "commits pre-existing trên branch trước session start" để reviewer không flag P1 nhầm scope worker; hoặc coordinator brief liệt kê range commit CHÍNH XÁC (lần này briefing thiếu c708e20 → reviewer phải tự phát hiện).
+MINI-RITUAL SF-1-FI77: 2 patterns → logged ở trên (chờ user review; không tự sửa skill)
+
+## 2026-10-13 — SF-2 FI-79 (outbox + relay + compensation)
+- **kafkajs subscribe() crash trước topic auto-create (SF-3 PHẢI áp)**: consumer `subscribe()` trước khi topic được broker auto-create xong → kafkajs 2.2.4 ném `UNKNOWN_TOPIC_OR_PARTITION` (retriable) RA NGOÀI subscribe() thay vì tự retry → unhandled rejection **crash cả process** (CI 38365465140: node-svc chết, readyz không bao giờ 200). Fix: bọc subscribe+run trong vòng retry backoff riêng (như connect) + `.catch` ở call site `void start()` (commit 6bcd3cb). go-svc consumer (SF-3) cùng pattern — giữa go workflow đã có kafka console producer tạo topic trước thì ít gặp, nhưng boot khi topic chưa có vẫn dính. (learned-date 2026-10-13)
+- **Reviewer dispatch read-based khi bash down**: bash msys chết ~50' → dispatch code-reviewer với brief đọc file trực tiếp (Read/Glob/Grep, không git diff) song song với chờ bash — review không trễ, khi bash sống chỉ còn commit. Mở rộng bash-down playbook SF-1. (learned-date 2026-10-13)
+- **schema-diff normalizer phải đi trước migration type mới**: drizzle-kit sinh `ALTER TABLE DROP/ADD CONSTRAINT` khi sửa CHECK — normalizer test throw ở DDL chưa handle → mở rộng normalizer CÙNG commit cascade (không để đỏ giữa chừng). Pattern cho mọi service có diff-test cấu trúc. (learned-date 2026-10-13)
+MINI-RITUAL SF-2-FI79: 3 patterns → logged ở trên (kafkajs subscribe crash = flag cho SF-3 qua DONE message; không tự sửa skill)
+
+## 2026-10-13 — SF-5 Convergence (FI-81, story FI-76)
+- **docker exec fail âm thầm trong script CI**: `docker compose exec` trong e2e.sh fail 3 run liền vì path bug `../platform` (script ở scripts/smoke/ cần `../../platform`) + stderr bị `2>/dev/null` nuốt. Bài học: (1) resolve path relative-to-script phải assert tồn tại (`[ -f "$COMPOSE_ENV" ]`) ngay đầu script; (2) KHÔNG nuốt stderr ở bước chẩn đoán — surface stderr trong failure message tiết kiệm 2-3 CI run (25 phút/run).
+- **Kafka group reader kẹt empty-assignment khi topic tạo sau subscribe**: tái xác nhận ở convergence (SF-3 đã hit ở go workflow — 8de8921). Composite boot order (pg+kafka → topics → full stack) nên là pattern chuẩn cho mọi compose-boot-smoke có Kafka.
+- **B1 evidence hash loop**: story-verify B1 chỉ grep HEAD hoặc HEAD~1 trong test-run.txt. Nếu sau evidence commit còn commit khác (tick plan...), HEAD~1 lệch → FAIL. Cách đúng: commit cuối trước story-verify PHẢI là commit có hash ghi sẵn trong evidence; khi có >1 commit sau evidence, thêm hash commit mới nhất vào evidence rồi commit evidence-sync LẦN CUỐI.
+- **worker_done cần dispatchId**: SF dispatch từ story bracket (không qua worker-start dispatch) gửi DONE bằng `--type status` --run <story-run-id> (precedent SF-1/SF-3); worker_done/type done sẽ reject thiếu dispatchId/taskId.
+
+## 2026-10-14 — SF-1 Design-system nền móng (VU-54, story VU-53)
+- **RUNTIME-006 cũng ăn vào REMOTE standalone entry (không chỉ host)**: mfToolkit $comment chỉ ghi lesson cho host (`import('./bootstrap')`); remote entry có JSX tĩnh (react/jsx-runtime shared) → loadShareSync trước share init → root trống ĐEN — đã crash trắng từ trước trên docker cũ ("trơ trụi" thực ra là crash, không phải chỉ thiếu style). mfToolkit READ-LOCKED nên lesson nằm ở: `remotes/*/src/index.tsx` comment + `evidence/sf-1-ui-redesign-dsys/spike-r2-result.md` addendum. Kit có thể thêm "remote entry async boundary" vào spike checklist.
+- **orca `click --element <ref>` không trigger React form submit** (login form gọi được requestSubmit chứ click ref không ăn — nghi stale ref sau re-render). Fallback đáng tin: fill bằng `focus` + `clear` + `type` (trusted keyboard) rồi `requestSubmit()` qua eval, hoặc dispatch native `.click()` trong eval. Ghi cho mọi browser-verify sau này.
+- **Consumer-provides-react khi lockfile freeze**: fe-shared JSX mà không được thêm dep → 3 lớp đối xứng bắt buộc: rspack `resolve.modules`, vitest `resolve.alias` + `esbuild.jsx:'automatic'`, tsconfig `paths` — thiếu lớp nào báo lỗi khác nhau (resolve fail / "React is not defined" / TS2307). Đã ghi contract vào fe-shared README.
+
+## 2026-10-14 — SF-2 Shell restyle (VU-55, story VU-53)
+- **Docker remoteEntry gateway-publicPath giết dev-loop direct-port**: remoteEntry build prod (:4001/:4002) mang publicPath `/remotes/<name>/` (gateway-shaped) — consume từ dev shell direct-port → chunk URL resolve về shell origin → 404 HTML → ChunkLoadError **giết cả bootstrap** (root trống, không console error rõ). Dev-loop spec: native dev remotes với `REMOTE_PUBLIC_PATH` tuyệt đối. SF-5 walkthrough compose :8080 không dính (gateway route khớp publicPath). (learned-date 2026-10-14)
+- **MF manifest eager-preload poison cross-remote**: remoteEntry của 1 remote fail lúc load trang → `loadRemote()` remote KHÁC cũng fail cả session (manifest batch); "Thử lại" không hồi phục trong session — phải reload sau khi remote sống. Walkthrough 4.4 "remote còn lại vẫn chạy" cần đọc là "nav sống + slot còn lại load được khi reload". Candidate fix (ngoài scope SF-2): loadRemote fallback tự re-fetch remoteEntry, hoặc walkthrough ghi bước reload. (learned-date 2026-10-14)
+- **DTS dev-worker đam port 4001 tùy hứng**: fork-dev-worker type-server đôi khi uncaughtException khi 4001 busy (docker) → giết dev server (1/4 lần); retry launch pass. Candidate: kit preflight check thêm "dev FE cluster cần 4001 free HOẶC retry". (learned-date 2026-10-14)
+- **Cụm port song song giữa SF**: SF-2 dùng 3200/4201/4202 để không đụng 3100/4101/4102 (SF-1 precedent) vì SF-3/4 chạy song song — conventions nên quy định "mỗi SF dev-cluster = base-port + offset riêng" (env đã hỗ trợ hết: SHELL_PORT/REMOTE_*_PORT/REMOTE_PUBLIC_PATH/API_BASE_URL=''). (learned-date 2026-10-14)
+MINI-RITUAL SF-2-VU55: 4 patterns → logged ở trên (2 flag SF-5/coordinator qua DONE message; không tự sửa skill)
+
+## 2026-10-14 — SF-3 Tasks redesign (VU-56, story VU-53)
+- **REMOTE_PUBLIC_PATH bắt buộc khi đổi port dev remote**: dev remote chạy port khác default (vd REMOTE_TASKS_PORT=4101) mà không set `REMOTE_PUBLIC_PATH=http://localhost:4101/` → remoteEntry advertised publicPath :4001 (default hardcode) → shell load expose xong nhưng chunk vendor fetch về compose container cũ → 404 im lặng → root TRỐNG, 0 console error. Diagnose tốn 1 vòng network-log. Config comment đã ghi nhưng nên nhắc trong context pack SF-4 (cùng sẽ chạy port lệch).
+- **Remote phải import tokens.css trong PAGE ENTRY (không chỉ standalone)**: SF-1 chỉ wire standalone.tsx import tokens+base; remote load TRONG shell (pre-SF-2, shell chưa import global) → mọi `var(--*)` trong scoped css unresolved (gap: normal, nền trắng). Fix SF-3: `import '@boilerplate/fe-shared/styles/tokens.css'` trong TasksPage.tsx (idempotent theo epic quyết định #5). **SF-4 sẽ hit y hệt** — nên thêm 1 dòng vào context pack sf-4 trước khi nó start, hoặc check khi review SF-4.
+- **Shell css cũ (pre-SF-2) có global `form{flex-direction:column;max-width:20rem}` đè implicit default của remote form**: class-scoped css không set `flex-direction`/`max-width` → rule global element cũ lấp vào → layout vỡ khó đoán. Pattern: remote scoped css nên explicit những property mà shell cũ từng set global (form/label/input). Tự hết khi SF-2 merge (shell css rewrite scoped) nhưng explicit không hại gì sau merge.
+- **story-verify B2 match file ĐẦU TIÊN chứa token `sf-<n>` alphabetically trong plans/ — có thể trúng plan CỦA STORY CŨ**: worktree `sf-3-ui-redesign-tasks` match `2026-10-12-sf-3-spring-svc-impact.md` (FI-62, hoàn tất lâu rồi) TRƯỚC plan của mình. May là impact file 0 unchecked `- [ ]` → B2 PASS; nếu file trúng có unchecked → false-FAIL chặn oan mọi SF sau. Đề xuất kit: B2 nên match plan theo worktree basename đầy đủ (hoặc slug story hiện tại), không phải token chung.
+- **use-swr-style race: mọi fetch cần stale-guard khi có 2 path ghi cùng state**: loadMore append + load replace cùng ghi `tasks/total` — response stale về sau phải bị bỏ qua sequence ref; và KHI thêm guard skip-toàn-phạm, check cả state-recovery (loadingMore bị skip reset → nút kẹt) — reviewer bắt được regression này ở round 2. Pattern: 1 flag async chỉ được reset ở ĐÚNG 1 owner; guard phải không phá ownership đó.
+## 2026-10-14 — SF-4 Activity redesign (VU-57, story VU-53)
+- **Verify 1 remote của mình qua shell dev → phải chạy DEV server cho TẤT CẢ remotes shell tham chiếu**: shell dev nạp eager remoteEntry + chunk của cả 2 remotes; remote compose (publicPath relative `/remotes/<name>/`) bị load cross-origin từ dev origin → chunk 404 → `ChunkLoadError` uncaught → bootstrap crash, root TRỐNG (nhầm là bug của remote mình). Pattern đúng = spike SF-1: mọi remote đều dev server riêng (absolute publicPath). Port :3100/:4101 dễ bị SF song song chiếm — chọn port lệch (3103/4103).
+- **Shell dev pre-SF-2 cần `API_BASE_URL=''` (same-origin qua dev proxy)**: mặc định dev = auth-mock :8090 trực tiếp → CORS chặn origin lạ (:3103) → login fail "Không kết nối được". Same-origin qua proxy chain của shell thì sạch.
+- **Orca browser screenshot có thể lag frame so với CSS async inject**: eval computed-style nói tokens đã load nhưng screenshot vẫn hiện frame cũ → "màu sai" ảo. Verify pixel-truth bằng decode PNG (đếm pixel trắng thuần ở vùng text) trước khi kết luận; không kết luận bug từ 1 nguồn (eval XOR screenshot).
+- **Vitest pin TZ qua `test.env: { TZ: ... }`** — bắt buộc với mọi test phụ thuộc ranh giới ngày local (timeline "Hôm nay/Hôm qua"); môi trường dev +07 che bug đến khi contributor/CI chạy TZ âm (review round 1 bắt được — meta-test RED trên TZ=America/New_York).
+
+## 2026-10-14 — SF-5 Convergence (VU-58, story VU-53)
+- **Stale compose stack = bẫy 2 lớp trước walkthrough**: (1) container image build TRƯỚC khi SF merge — UI cũ chạy ngon, tưởng là UI mới; (2) browser tab giữ bundle/HTML stale sau khi image rebuild — goto cùng URL không refetch (CSS hash cũ 404 → unstyled, text mới + style cũ MUA được nhìn như bug). Quy trình bắt buộc: `docker ps` xem tuổi container vs merge-time → rebuild (`docker compose up -d --build`) → navigate với cache-bust query → ĐO `getComputedStyle(document.body).backgroundColor` khớp token (`#010102`) trước khi tin mắt. (learned-date 2026-10-14)
+- **Mất platform/.env nhưng stack còn chạy → reconstruct từ container**: compose `name:` cố định (vd `boilerplate`) nên `up` từ worktree KHÁC vẫn vào cùng project; env thật đọc bằng `docker inspect <ctr> --format '{{range .Config.Env}}…'` (distroless go-svc không exec được). Viết lại .env (gitignored) là đủ để rebuild app containers mà không mất pgdata/topics (kafka không có volume — KHÔNG down). (learned-date 2026-10-14)
+- **Orca browser input limits (mở rộng finding SF-1)**: ngoài stale-ref click, (a) trusted CDP mouse/keypress KHÔNG route vào page nền (Enter trên button focused cũng không fire); (b) element-click theo snapshot-coords miss khi element dưới fold/sau scroll/reset. Verification pattern thay thế (trung thực, khai báo trong evidence): JS activation (`.click()`) + `elementFromPoint` (chứng minh không overlay) + requestlog (`performance.getEntriesByType('resource')`) + suite coverage. Phân biệt app-bug vs tool-artifact bằng CONTROL test trên element cùng loại. (learned-date 2026-10-14)
+- **Standalone prod-build treo trắng = share-scope factory chunk ma (BUG-1)**: rspack MF build sinh factory react-dom `Promise.all([e("237"),e("221")])` mà "237" không nằm trong chunk map (local build thiếu "46" — id KHÔNG ổn định nhưng class lỗi ổn định). Chẩn đoán 5 phút: grep `__webpack_require__.e("N")` trong `dist/main.*.js` vs ids trong chunk-map `{N:"hash16"}` → thiếu = treo vô hạn KHÔNG fetch. In-shell không apparent vì host provide react (factory không chạy). Dev server OK (chunking khác) → acceptance chỉ nhìn compose sẽ miss nếu không test standalone prod. Kit: thêm "grep phantom chunk" vào spike checklist MF. (learned-date 2026-10-14)
+- **Phân loại bằng chứng "retry không ăn"**: skeleton flash 300ms (handler CHẠY, lazy recreate) + 0 request mới (import fail tức thì) + raw `import(remoteEntry)` cùng page FETCH được → sticky layer nằm trong MF runtime (khớp finding SF-2 "manifest eager-preload poison"). Không cần đọc code shell để kết luận — 3 đo này đủ định vị owner. (learned-date 2026-10-14)
+- **Story-diff security scan cần timeline check**: `merge-base(origin/main)..HEAD` chứa commit infra của coordinator (c3b1499 — nginx lazy-map + BSD-sed) 19' SAU story CREATE → report "untouched violation" nhầm nếu không `git log -- <file>` so thời điểm. CSP/security headers mới là đối tượng scan, không phải mọi delta vs main. (learned-date 2026-10-14)
+- **scaffold.sh macOS portability (pre-existing SF-7)**: `realpath -m` (line 40, BSD không có) + `sed -i` GNU syntax (rename step chết sớm, rename thành no-op). Verify-only workaround: PATH-shim realpath; copy+prune+design-system+install+build OK, rename skip. CI Linux không ảnh hưởng. (learned-date 2026-10-14)
+MINI-RITUAL SF-5-VU58: 7 patterns → logged ở trên (BUG-1/BUG-2 report coordinator qua worktree comment; không tự sửa skill)
+
+## 2026-10-14 — SF-5b fix round (VU-58 round 2, story VU-53)
+- **BUG-1 là 2 bug xếp lớp, không phải 1**: phantom-chunk (build output stale ids) + alias-nginx (index.html/runtime chunk fetch dùng publicPath gateway-shaped trong khi standalone nginx chỉ serve root). Fix lớp 1 xong trang VẪN trắng nếu chỉ nhìn "có fetch" — phải nhìn MIME/text/html-as-js. Fix đứng ở nginx (`location /remotes/<name>/` alias về root) thay vì đổi publicPath vì runtime `.p` compile-time bắt buộc gateway-shaped cho in-shell — một dist phục vụ 2 đường. (learned-date 2026-10-14)
+- **Workaround toolchain cho phantom chunk mà không bump pin: 2-entry split** — entry `index` giữ async boundary làm anchor MF container (RUNTIME-006), entry `standalone` STATIC bundle cả graph vào 1 chunk self-contained (shared eager:true inline sync) → async chunk cho shared không còn tồn tại → phantom không thể sinh. Static grep sau fix: standalone.*.js refs=[] ở cả 2 remote. (learned-date 2026-10-14)
+- **Sticky rejection BUG-2 = memoized-promise không clear-on-reject**: runtime-core 0.21.6 `getRemoteEntry()` cache load-promise trong `globalLoading` (window.__GLOBAL_LOADING_REMOTE_ENTRY__, key name+entry) — rejected promise ở lại mãi → mọi loadRemote sau nhận lại rejection cũ, 0 fetch. Đường sanctioned reset: `registerRemotes([{name, entry, type:'global', shareScope:'default'}], {force:true})` → removeRemote xoá globalLoading + manifestCache + moduleCache + container global (crux: moduleCache.set xảy ra TRƯỚC fetch nên lần load fail vẫn có cache → cleanup chạy được — reviewer verify với source). Def retry PHẢI khớp registration gốc: type 'global' (def 'module' → fetch 200 xong chết RUNTIME_002 — bắt bằng cách attach .catch lên chính rejected promise trong globalLoading qua eval). (learned-date 2026-10-14)
+- **Phân loại residual stale refs: so sánh với build cũ đang chạy OK** — docker cp remoteEntry từ container cũ cho thấy old expose map cũng await phantom "237" mà in-shell vẫn chạy → in-shell không đi qua container.get của remote (mf runtime host-side drive) → residual cùng class = vô hại, không phải regression. Đừng "sạch hoá" residual vô hại bằng thay đổi risk-ô. (learned-date 2026-10-14)
+MINI-RITUAL SF-5B-VU58: 4 patterns → logged ở trên (kit MF spike checklist: thêm "retry def phải khớp registration gốc" + "alias 2 lớp"; không tự sửa skill — Principle 6)
+
+## 2026-10-17 — cross-session day (renames app/@wakii + skills + CI copy-dir)
+- **Reproduce CI bug ở local phải pin ĐÚNG version tool**: copy-dir fail 22s trên CI nhưng local PASS — vì local pnpm 12.8.1 chịu mini-workspace catalog-only, còn CI pnpm 9.15.9 chết ngay `ERROR packages field missing or empty`. 3 iteration fix sai lớp (corepack pin, $REPO_ROOT) vì tín hiệu local sai. Quy tắc: trước khi tuyên bố "reproduced", chạy tool đúng version CI (`npx pnpm@<ver>`); fix thật = `packages: ['.']` + `add -Dw` — run 39014478754 PASS 37s. (learned-date 2026-10-17)
+- **Mutation orca từ pane ngoài = consumer_fenced (by design)**: task-update/gate-resolve trên run của coordinator-pane khác bị fence. Với state stale (SF-5 'ready' dù story đã merge): chuẩn bị sẵn lệnh + result-text trỏ evidence cho pane gốc chạy; nhớ `--run run_xxx` tường minh không có là run_required. (learned-date 2026-10-17)
+- **Shared-worktree multi-session: commit pathspec + kiểm tra trước mỗi lệnh git**: nhánh đổi dưới chân liên tục (5 nhánh/1 ngày, session khác commit/xóa/rebase song song) — `git commit -- <paths>` chặn nuốt staged của người khác (đã xảy ra 1 lần, tách lại được); bắt đầu mỗi thao tác bằng `git log --oneline -3 && git status`. (learned-date 2026-10-17)
+
+## 2026-10-17 — SWEEP toàn bộ flags (đợt đầu tiên; tiêu chí lọc từ wakii-playbook §6: lặp ≥2 → conventions, một-lần → đóng khi đã fix)
+
+**ĐÓNG — đã materialize ở nơi khác (verify bằng grep ngày sweep):**
+
+| Flag gốc | Đã ở đâu |
+|---|---|
+| conventions/01 thiếu variant standalone lockfile | conventions/01 dòng 76 (Local standalone lockfile) |
+| schemathesis mirror rule healthz/readyz | conventions/02 rule 6 |
+| requiredVersion: false cho singleton remote | conventions/08 rule 4 |
+| README node-svc thiếu dep contracts/db | node-svc README dòng 5 + 152 |
+| fe-shared loadRemoteModule defect | fix c81309d + test mf-retry shell |
+| kafkajs subscribe() crash trước topic | fix 6bcd3cb + pattern tạo-topic-trước (convergence + playbook NS) |
+| consumer-provides-react 3 lớp đối xứng | fe-shared README |
+| B1 evidence hash loop (HEAD~1) | story-verify có accommodation HEAD~1; playbook anti-patterns |
+| catalog + standalone mini workspace | convergence.yml (nâng cấp 2026-10-17: + packages:['.'] cho pnpm 9.15.9) + playbook IN |
+| schema-diff normalizer đi trước migration | skill sync-contracts (quy tắc đồng bộ cặp) |
+| orca id-capture .result.* / B4 executor-view / sed BSD | playbook anti-patterns (flag kit-helper vẫn mở — xem dưới) |
+| story-guard WAKII_GUARD_OFF | hook message giờ tự ghi hướng dẫn override |
+| MF manifest poison / REMOTE_PUBLIC_PATH | fix sf-5b (retry bust) + comment config + playbook |
+
+**MỞ — owner ngoài repo này (kit `~/.claude/bin` / orca CLI / skill repo), giữ nguyên:**
+- pino/FastifyBaseLogger cast + quyết `additionalProperties` chung 3 service (P2 kiến trúc — cần coordinator)
+- story-plan-validate + story-verify: cp1252/python3 fallback (dup 2 mục) · B4 `--executor-view`
+- orca CLI: helper capture `.result.*` id · pacing task-create · PATH MSYS/class · python shim Windows
+- workflow-templates: note action-setup `version:` · note `--env-file` cho log-dump · YAML block-scalar gotchas
+- bash-down playbook → rollback-ritual.md · reviewer brief "pre-existing commits" · task-update vocabulary vào SKILL.md
+
+**Kết luận:** không có lesson nào đủ điều kiện lên conventions mới — 9 conventions hiện tại phủ hết các pattern lặp. Nợ duy nhất mang tính quyết định: `additionalProperties` P2 (C-hàng, cần 1 quyết định coordinator ghi vào conventions/04).
+
+## 2026-10-17 — SF-1 auth-real (VU-60)
+- [p6-flag] Context pack gap-item viết shorthand CLI thiếu precision: sf-1.md ghi "Exclude register|refresh|logout" → session trước implement `--exclude-path "login|register|refresh|logout"` nhưng schemathesis 3.39 `--exclude-path` là EXACT match (không filter path nào → /login vẫn bị fuzz → CI đỏ oan). Đúng: `--exclude-path-regex` + phải exclude cả `/login` (shape v2 decision #8 vs auth-mock v1). Fix tại chỗ: contracts.yml comment + chạy thật chứng minh 8→3 ops. Suggested: context-pack/gap-item nhúng CLI flag + semantics đúng theo `--help` của version pin, không viết shorthand regex-ngoài-hình.
+- [p6-flag] CI contracts job boot-smoke vẫn assert TTL=28800/iss trên auth-mock (đúng design chuyển tiếp — SF-5 swap); SF-5 phải nhớ bỏ/nới các assert này khi boot auth-svc (đã ghi trong spec CI ownership, reviewer xác nhận không phải sót).
+
+## 2026-10-17 — SF-2 auth-real (VU-61)
+- [pattern] Fastify route-level `preHandler` dạng SYNC arrow (không async) làm hook-runner STALL khi guard PASS (request không hoàn tất — timeout), còn path throw chạy bình thường (403 về đúng). A/B probe xác nhận: sync → treo, async → full chain 204. Fix: luôn `async` cho preHandler trong route options. Áp dụng cho mọi service Fastify trong boilerplate (node-svc hiện tại + auth-svc SF-2 mirror).
+- [gotcha] Máy dev này: brew postgresql@16 bind 127.0.0.1/::1:5432 → docker container postgres (compose) KHÔNG với được từ host qua localhost — kết nối luôn rơi vào brew cluster. Boot service cục bộ cần DB: dùng scratch DB trên brew cluster (hoặc docker exec trong container). Drizzle nuốt pg error gốc — moi qua `err.cause` (code 28000 = auth/role).
+- [p6-flag] Epic-level gap: RBAC 403 chưa khai trong tasks.yaml (SF-1 gap-answer 8 mục miss mục contracts tasks.yaml; plan Task 3 cũng không có step contracts). Đã route REQUIREMENT-GAP VU-59 (comment 8ac61a18) với patch 5 bước + 2 options; merge-level condition: patch phải land trước merge SF-3/trước SF-5. Suggested: context-pack template cho SF kiểu "thêm response code mới" phải có mục contracts-sync trong touch map (nguyên tắc vàng #1 — contracts trước code).
+## 2026-10-17 — SF-4 auth-real (VU-63)
+- [p6-flag] drizzle-kit 0.31 generate `CREATE SCHEMA "auth";` KHÔNG có IF NOT EXISTS (node-svc 0000 là bản cũ có IF NOT EXISTS) + migrations_history nằm TRONG schema auth → migrate runner PHẢI ensure schema TRƯỚC khi tạo history table (fresh DB nổ 3F000). Pattern "service mới có schema riêng" = copy auth-svc db/migrate.ts (ensureAuthSchema try/verify to_regnamespace) chứ không copy node-svc nguyên trạng. Suggested: skill sync-contracts/add-service thêm note 2 dòng.
+- [p6-flag] Multi-SF song song: session SF-4 spawn stub (`/tmp/auth-stub-*.mjs`) chiếm :8091 → port clash khi 2 SF cùng dev boot. Lesson: trước khi boot dev, `lsof -iTCP:<port> -sTCP:LISTEN` + `ps <pid>` xác định chủ process — process session KHÁC thì đổi port mình, KHÔNG kill. Suggested: playbook multi-SF note "port etiquette".
+- [lesson] DrizzleQueryError (drizzle-orm ≥0.44) bọc PG code vào `err.cause.code` — route check `err.code === '23505'` sẽ không bao giờ match. Normalize ở repo layer (DrizzleAuthRepo.createUser rethrow .code='23505') để giữ contract AuthRepo.
+## 2026-10-17 — SF-4 auth-real (VU-63)
+- [p6-flag] Evidence/docs path phải tạo bằng đường TUYỆT ĐỐI từ repo root: session chạy `mkdir -p docs/superpowers/evidence/...` khi CWD đang là `app/shell` → evidence rơi `app/shell/docs/...`, ngoài touch map (code-reviewer bắt ở P1). Suggested: story-workflow/task-executor briefing ghi sẵn lệnh evidence với `$REPO_ROOT` absolute; hoặc kit thêm pre-commit guard chặn `app/*/docs/`.
+- [p6-flag] B3 gate cần literal `VERDICT...APPROVED` trong comment Linear — DONE-report comment chỉ viết "Round 2 **APPROVED**" (không có từ VERDICT) → B3 kẹt OUTBOX 1 vòng, phải post comment verdict riêng. Suggested: checklist DONE-comment của task-executor thêm dòng bắt buộc `VERDICT: APPROVED` (copy nguyên từ verdict file) thay vì paraphrase.
+## 2026-10-17 — SF-5 auth-real (VU-64)
+- [p6-flag] Plan prose assert sai contract: plan Task 5 Step 2 ghi "alice DELETE → 200" nhưng tasks.yaml + node-svc trả **204** (DELETE No Content) — e2e fail bước 12 lần chạy đầu vì assert theo prose. Fix tại chỗ: e2e assert 204 theo tasks.yaml (nguồn sự thật — nguyên tắc vàng #1). Suggested: writing-plans-linear template — assert trong plan PHẢI quote status code từ spec (kèm path §section), không viết prose "→ 200" theo cảm tính.
+- [p6-flag] Orca browser coordinate-clicks thỉnh thoảng trượt trên element do REMOTE mount (shell element ổn, remote tasks element "Clicked" OK nhưng handler không nhận — kể cả keypress Enter). Workaround đã verify: `requestSubmit()` cho form + `HTMLElement.click()` từ eval (React synthetic không cần isTrusted). Suggested: kit story-test/browser task thêm pattern "remote element không nhận trusted click → fallback requestSubmit/element.click() + khai báo trong evidence" (lặp lại class bug FI-464 CDP-screenshot — cùng họ "Orca browser không surface trusted input xuống remote MF").
+- [pattern] Schemathesis FULL pass nguyên vẹn khi auth-svc implement đúng spec đủ response codes (104/104) — bỏ exclude SF-1 an toàn vì auth.yaml v2 khai đủ 201/400/401/409/204/403... Pattern: "nới schemathesis scope" chỉ cần assert lần đầu local trước khi commit CI diff, không cần thêm exclude bảo thủ.
+- [gotcha] Compose project name `boilerplate` DÙNG CHUNG giữa các worktree story (không per-worktree) — down -v ở 1 worktree giết volume stack worktree khác đang chạy. SF convergence phải down -v → warn trong briefing + kiểm `docker ps` trước.
+- [pattern] Renumber nhiều bước script: LABEL và EXIT CODE là 2 mặt của cùng contract — renumber 1 trong 2 thôi tạo collision im lặng (SF-5: thêm 6 bước renumber say-label nhưng quên fail N → exit 7/8/9/10 mỗi code 2 bước; code-reviewer bắt P1). Meta-test nhỏ: `grep fail N | sed | sort | uniq -c` rồi đối chiếu block — mỗi exit code đúng 1 block bước. Suggested: task-executor checklist khi đổi step numbering "label ↔ exit map bảng 2 cột, sửa cả 2 cột cùng lúc".
+
+> **Disposition SF-5 (ritual 2026-10-17)**: plan-assert quote-spec → flagged cho writing-plans-linear (chờ user duyệt); exit-code label↔exit map → PATCHED ~/.claude/agents/task-executor.md (Label↔exit map rule); remote-click fallback → PATCHED orca-superpowers-workflow SKILL.md (blockquote CDP fallback); compose-shared gotcha → user auto-memory (compose-project-shared-across-worktrees) + ghi walkthrough evidence; schemathesis-nới → không cần update (one-off assert local); heredoc-quote → no-op (generic bash, skip trung thực).

package/stack-template/docs/superpowers/mindmaps/auth-real.wakii

@@ -0,0 +1,115 @@
+{
+  "wakiiMindmap": 1,
+  "meta": {
+    "story": "VU-59",
+    "generator": "story-workflow CREATE",
+    "generatedAt": "2026-10-17T17:30:00+07:00",
+    "dest": "story-vu59-auth-real",
+    "worktreeModel": "story-hub"
+  },
+  "nodes": [
+    {
+      "id": "epic",
+      "kind": "epic",
+      "title": "Auth thật thay auth-mock — register/login/refresh/RBAC",
+      "summary": "Thay auth-mock bằng auth-svc thật giữ nguyên surface :8090 /api/auth/*. Spec rev2: docs/superpowers/specs/2026-10-17-auth-real-design.md · Plan rev2: docs/superpowers/plans/2026-10-17-auth-real-plan.md · Epic đầu tiên áp dụng wakii-playbook (archetype CC). Linear: VU-59."
+    },
+    {
+      "id": "sf-1",
+      "kind": "sf",
+      "title": "Contracts + hiệp ước + gap-answer",
+      "tier": 0,
+      "summary": "auth.yaml v2 (register/refresh/logout + giữ GET /users, drop openid stub, response shape {user,accessToken,refreshToken}) + token-contract v2 (iss PINNED auth-mock, access 30m/refresh 7d, CAS rotation + reuse strict all-user, bp.rt rationale) + schemathesis scope contracts.yml + gap-answer 8 mục cho shared files. Gate: spectral + schemathesis scoped.",
+      "linear": "VU-60"
+    },
+    {
+      "id": "sf-2",
+      "kind": "sf",
+      "title": "auth-svc — schema + seed + 5 endpoints",
+      "tier": 1,
+      "summary": "Phase 1/2 — shippable: auth-svc (Fastify+TS+Drizzle, mirror node-svc) boot độc lập: register→login→refresh (CAS rotation + reuse strict)→logout hoạt động đầu-cuối qua integration test; seed 5 user fixture giữ UUID; workflow services-auth-svc.yml xanh.",
+      "linear": "VU-61"
+    },
+    {
+      "id": "sf-3",
+      "kind": "sf",
+      "title": "node-svc RBAC — DELETE admin-only",
+      "tier": 1,
+      "summary": "DELETE /api/tasks/:id yêu cầu roles admin: bob 403 envelope FORBIDDEN, alice 200 — unit test RED→GREEN chứng minh. Chạy tier Standard (SF nhỏ, vùng file tách bạch).",
+      "linear": "VU-62"
+    },
+    {
+      "id": "sf-4",
+      "kind": "sf",
+      "title": "FE refresh-client + LoginPage register",
+      "tier": 1,
+      "summary": "refresh-client.ts (file mới, READ-LOCKED nguyên vẹn): login/register lưu cặp token, 401 → auto-refresh single-flight → retry; LoginPage tab Register (Tailwind v4 đã trên main — theo pattern mới); logout clear sạch. Coverage gate 90/90/80/90 + a11y giữ.",
+      "linear": "VU-63"
+    },
+    {
+      "id": "sf-5",
+      "kind": "sf",
+      "title": "Convergence + decommission + CI swap + docs",
+      "tier": 2,
+      "summary": "Phase 2/2 — shippable: auth-mock out, auth-svc thay vị trí :8090 (thực thi gap-answer 8 mục); e2e mở rộng register→refresh→reuse→401→RBAC 403; CI swap 3 workflows — toàn main xanh; docs sync rộng + gotcha down-v; security pass 0 P0/P1; human walkthrough 2 tab.",
+      "linear": "VU-64"
+    }
+  ],
+  "edges": [
+    {
+      "from": "epic",
+      "to": "sf-1",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-2",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-3",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-4",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-5",
+      "rel": "contains"
+    },
+    {
+      "from": "sf-2",
+      "to": "sf-1",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-3",
+      "to": "sf-1",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-4",
+      "to": "sf-1",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-5",
+      "to": "sf-2",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-5",
+      "to": "sf-3",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-5",
+      "to": "sf-4",
+      "rel": "depends-on"
+    }
+  ]
+}

package/stack-template/docs/superpowers/mindmaps/kafka-outbox-saga.wakii

@@ -0,0 +1,110 @@
+{
+  "wakiiMindmap": 1,
+  "meta": {
+    "story": "FI-76",
+    "generator": "story-workflow CREATE",
+    "generatedAt": "2026-10-13T03:20:00+07:00",
+    "dest": "story-fi76-kafka-outbox-saga",
+    "worktreeModel": "story-hub"
+  },
+  "nodes": [
+    {
+      "id": "epic",
+      "kind": "epic",
+      "title": "Kafka + Transactional Outbox + Saga (mở rộng FI-62)",
+      "summary": "Nâng luồng event từ REST fire-and-forget lên Kafka KRaft + Transactional Outbox + Saga choreography; thêm @Transactional demo spring. Spec: docs/superpowers/specs/2026-10-13-kafka-outbox-saga.md rev 3 (spec-critic + plan-critic FIX-P0-FIRST đã áp). CI-only verify."
+    },
+    {
+      "id": "sf-1",
+      "kind": "sf",
+      "title": "Kafka foundation + async contracts",
+      "tier": 0,
+      "summary": "Phase 1/2 — shippable: nền tảng. Compose kafka KRaft (apache/kafka, heap 512m, healthcheck full-path, internal-only, không depend_on); PRE-ADD env consumers (KAFKA_BROKERS node+go, AUTH_MOCK_URL + SVC_ACTIVITY_PASSWORD go) đúng 1 lần sửa compose; contracts/events/task-events.md (envelope + payload shapes + filter-by-type) + golden fixtures/*.json (2 đầu test load chung); conventions/09; fixtures svc-fail + svc-activity users.json; ADR-0008 supersede 0006. KHÔNG đụng DDL/tasks.yaml/activity.yaml. Context pack: docs/superpowers/contexts/sf-1.md",
+      "linear": "FI-77"
+    },
+    {
+      "id": "sf-4",
+      "kind": "sf",
+      "title": "spring-svc @Transactional demo",
+      "tier": 0,
+      "summary": "Phase 1/2 — shippable độc lập (false dep đã cắt — dùng alice@demo.local có sẵn, không dính Kafka). TeamService service layer: tạo team + members N step, fail giữa chừng (email trùng alice) → rollback toàn bộ; tests happy + rollback assert; README Situation A vs B. Context pack: docs/superpowers/contexts/sf-4.md",
+      "linear": "FI-78"
+    },
+    {
+      "id": "sf-2",
+      "kind": "sf",
+      "title": "node-svc Outbox + Producer + compensation consumer",
+      "tier": 1,
+      "summary": "Phase 1/2 — shippable: node publish qua Kafka thật. Cụm nguyên tử node-side cascade (canonical DDL CHECK + schema.ts + migration + tasks.yaml TaskStatus split writable/extended); outbox table (envelope id trong repo, presence-based event matrix); relay 500ms kafkajs đúng golden fixture; xóa clients/activity.ts; compensation consumer conditional UPDATE; services-node-svc.yml kafka boot-smoke (assert published_at NOT NULL); pin schema-diff.test whitelist outbox. Context pack: docs/superpowers/contexts/sf-2.md",
+      "linear": "FI-79"
+    },
+    {
+      "id": "sf-3",
+      "kind": "sf",
+      "title": "go-svc Consumer + Saga + thanh lý ingest",
+      "tier": 1,
+      "summary": "Phase 1/2 — shippable: go consume Kafka thật. Cụm nguyên tử activity-side cascade (migration 0002 varchar(40)+CHECK; activity.yaml ×2 file trọn gói + diff-guard; store/tasks.go map; FE remote-tasks badge + remote-activity labels); consumer segmentio manual-commit ON CONFLICT filter-by-type; retry×3 → compensating → DLQ; resolver svc-activity backoff + lazy re-login; xóa ingest; services-go-svc.yml 3 điểm chạm (console producer golden fixture + kafka subset + topics tường minh + stats nới). Context pack: docs/superpowers/contexts/sf-3.md",
+      "linear": "FI-80"
+    },
+    {
+      "id": "sf-5",
+      "kind": "sf",
+      "title": "Convergence + ADR sync + docs",
+      "tier": 2,
+      "summary": "Phase 2/2 — shippable: STORY-COMPLETE candidates. convergence.yml 10 services + poll nới; e2e 2 chiều: happy (tạo task → feed) + saga (assign svc-fail → status assignment_failed + assert DLQ kafka-console-consumer); FE verify tổng thể; walkthrough + down -v note; security pass (9092 internal, secrets không vào envelope); scaffold probe. Context pack: docs/superpowers/contexts/sf-5.md",
+      "linear": "FI-81"
+    }
+  ],
+  "edges": [
+    {
+      "from": "epic",
+      "to": "sf-1",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-4",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-2",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-3",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-5",
+      "rel": "contains"
+    },
+    {
+      "from": "sf-2",
+      "to": "sf-1",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-3",
+      "to": "sf-1",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-5",
+      "to": "sf-2",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-5",
+      "to": "sf-3",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-5",
+      "to": "sf-4",
+      "rel": "depends-on"
+    }
+  ]
+}

package/stack-template/docs/superpowers/mindmaps/micro-boilerplate.wakii

@@ -0,0 +1,171 @@
+{
+  "wakiiMindmap": 1,
+  "meta": {
+    "story": "FI-62",
+    "generator": "story-workflow CREATE",
+    "generatedAt": "2026-10-12T10:30:00+07:00",
+    "dest": "story-fi62-micro-boilerplate",
+    "worktreeModel": "story-hub"
+  },
+  "nodes": [
+    {
+      "id": "epic",
+      "kind": "epic",
+      "title": "Boilerplate Microservice + Micro-frontend",
+      "summary": "Template nội bộ copy-able: mixed-stack services (Node/Spring/Go) + Module Federation FE, demo e2e task management qua nginx gateway, Docker Compose + CI. Spec: docs/superpowers/specs/2026-10-12-boilerplate-microservice-mfe.md rev 3."
+    },
+    {
+      "id": "sf-1",
+      "kind": "sf",
+      "title": "Contracts & Platform Foundation",
+      "tier": 0,
+      "summary": "Phase 1/3 — shippable: nền tảng. OpenAPI specs + canonical tasks DDL + users fixture + token contract; conventions (healthcheck, JSON log, error envelope, port table, CORS dev); compose PRE-SEED đủ khung 6 services + postgres init (readonly grants qua default privileges); nginx gateway; auth-mock; fe-shared kèm spike MF/Rspack pin versions; CI templates (path-filter + boot-smoke + gitleaks). Demo: swagger auth-mock login nhận JWT hợp lệ; CI contract lint xanh. Context pack: docs/superpowers/contexts/sf-1.md",
+      "linear": "FI-64"
+    },
+    {
+      "id": "sf-2",
+      "kind": "sf",
+      "title": "node-svc — task API (Fastify + TS)",
+      "tier": 1,
+      "summary": "Phase 1/3 — shippable: task CRUD qua gateway, user validate qua spring (timeout 2s, fail-closed 503), event push fire-and-forget sang go-svc, migration khớp canonical DDL, boot-smoke CI. Demo: swagger tạo/list task. Context pack: docs/superpowers/contexts/sf-2.md",
+      "linear": "FI-70"
+    },
+    {
+      "id": "sf-3",
+      "kind": "sf",
+      "title": "spring-svc — user API (Spring Boot 3)",
+      "tier": 1,
+      "summary": "Phase 1/3 — shippable: users + teams CRUD, seed đọc users fixture (id khớp 100%), JWT service-side verify, Flyway migration, mvnw wrapper, boot-smoke CI. Demo: swagger GET fixture user. Context pack: docs/superpowers/contexts/sf-3.md",
+      "linear": "FI-71"
+    },
+    {
+      "id": "sf-4",
+      "kind": "sf",
+      "title": "go-svc — activity API (Go 1.24 + chi)",
+      "tier": 1,
+      "summary": "Phase 1/3 — shippable: nhận POST /activity/events, feed + stats (đọc readonly schema tasks theo canonical DDL), tự migrate schema activity, readonly-read exit criterion (seed qua owner role), boot-smoke CI. Demo: swagger-ui POST event → feed. Context pack: docs/superpowers/contexts/sf-4.md",
+      "linear": "FI-72"
+    },
+    {
+      "id": "sf-5",
+      "kind": "sf",
+      "title": "FE shell — MF host (Rspack)",
+      "tier": 1,
+      "summary": "Phase 2/3 — shippable: shell login mock JWT, nav + routing, load remotes theo registry, error boundary remote-down, a11y baseline có test (route focus + skip link). Task đầu: re-validation spike SF-1 + fe-shared fit-check. Context pack: docs/superpowers/contexts/sf-5.md",
+      "linear": "FI-73"
+    },
+    {
+      "id": "sf-6",
+      "kind": "sf",
+      "title": "FE remotes — tasks + activity",
+      "tier": 2,
+      "summary": "Phase 2/3 — shippable: 2 remote gọi service thật qua gateway (tạo task qua node-svc; feed/stats qua go-svc), shared singletons theo catalog, boot-smoke per remote (remoteEntry fetch được). Context pack: docs/superpowers/contexts/sf-6.md",
+      "linear": "FI-74"
+    },
+    {
+      "id": "sf-7",
+      "kind": "sf",
+      "title": "Convergence & Scaffold",
+      "tier": 3,
+      "summary": "Phase 3/3 — shippable: e2e smoke script committed + CI job (login → tạo task → đọc feed qua gateway), copy-dir standalone smoke, health-gated compose, docs + ADR + fresh-clone walkthrough, scaffold script (trễ = scope-flag, không auto-complete), security-audit checkpoint. Context pack: docs/superpowers/contexts/sf-7.md",
+      "linear": "FI-75"
+    }
+  ],
+  "edges": [
+    {
+      "from": "epic",
+      "to": "sf-1",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-2",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-3",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-4",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-5",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-6",
+      "rel": "contains"
+    },
+    {
+      "from": "epic",
+      "to": "sf-7",
+      "rel": "contains"
+    },
+    {
+      "from": "sf-2",
+      "to": "sf-1",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-3",
+      "to": "sf-1",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-4",
+      "to": "sf-1",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-5",
+      "to": "sf-1",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-6",
+      "to": "sf-1",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-6",
+      "to": "sf-2",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-6",
+      "to": "sf-4",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-7",
+      "to": "sf-2",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-7",
+      "to": "sf-3",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-7",
+      "to": "sf-4",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-7",
+      "to": "sf-5",
+      "rel": "depends-on"
+    },
+    {
+      "from": "sf-7",
+      "to": "sf-6",
+      "rel": "depends-on"
+    }
+  ]
+}