From e3c8db48ae0000ab63c15d2ee09a672140c408ca Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 8 Nov 2026 11:24:43 +0900 Subject: [PATCH] =?UTF-8?q?chore(features):=20=EC=B0=B8=EC=A1=B0=20?= =?UTF-8?q?=EA=B8=B0=EB=8A=A5=EA=B3=BC=20=EC=98=88=EC=A0=9C=20=ED=99=94?= =?UTF-8?q?=EB=A9=B4=EC=9D=84=20=EC=A7=80=EC=9A=B0=EA=B3=A0=20=EB=A0=88?= =?UTF-8?q?=EC=A7=80=EC=8A=A4=ED=8A=B8=EB=A6=AC=EB=A5=BC=20=EB=8B=A4?= =?UTF-8?q?=EC=8B=9C=20=EC=8A=B9=EC=9D=B8=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 소유자 결정(2026-11-07, design-docs repo-structure/README.md 3.4절)으로 템플릿 샘플을 지운다. 샘플이 맡던 시험 대상은 앞 커밋들이 옮겼다. 참조 기능과 예제 화면, 두 context, 그 시험, e2e 3개, 수동 접근성 기록 7개, 런타임 프로필 키, test:reference-feature(명령, 산출물, 게이트 참조), 커버리지 정책 행을 지웠다. removable-template-features 목록은 비우고 장치는 남겼다: test:sample-removal은 인자가 없으면 목록을 하나씩 지우고, 비면 SKIP을 출력하고 보고서에 건너뛴 사례를 남긴다. 기능 스위치 시험과 홈 시작 링크 스위치 시험은 시험 전용 fixture 기능으로 옮겼다. browser soak은 생성 기능을 넣은 빌드에서 돈다. 문서의 샘플 경로를 고쳤다. 날짜가 붙은 설계·리뷰 기록의 본문은 그대로 두었다. 레지스트리 기준선(update:registry-baseline, OWNER DongHyeonka), CI 계약 기준선과 workflow, 초기 JS 기록(194,354B, 17파일, 첫 기능 6,327B, 기능 539B, context 4B)을 다시 받았다. 위험: 레지스트리 행 삭제는 breaking이다. 샘플을 고쳐 쓰는 다운스트림은 수정/삭제 충돌을 만난다. 성능 lab의 기능 라우트 측정은 템플릿에 공개 기능 라우트가 없어 measured:false다. TEMPLATE_FIXTURE 출처는 플랫폼 코드에 남았다. 검증(desktop): check:types, lint, check:architecture, check:registries, check:ci, verify:documentation, test:unit, test:component, test:contract, test:integration, test:recipes, test:coverage(Risk coverage PASS 378/378, 문턱 68개), test:e2e 183, test:a11y, test:visual, test:storybook, test:browser-capabilities, test:feature-scaffold PASS(76 checks), test:sample-removal SKIP, build, check:bundle. --- PRODUCT.md | 4 +- README.md | 37 +- artifacts/tests/a11y-manual/EXAMPLES_AUTH.md | 18 - .../tests/a11y-manual/EXAMPLES_STATES.md | 18 - artifacts/tests/a11y-manual/EXAMPLES_UI.md | 18 - .../a11y-manual/REFERENCE_RESOURCE_DETAIL.md | 18 - .../a11y-manual/REFERENCE_RESOURCE_FORM.md | 18 - .../a11y-manual/REFERENCE_RESOURCE_LIST.md | 18 - .../a11y-manual/REFERENCE_RESOURCE_STATUS.md | 18 - config/ci/contract-baseline.json | 10 +- config/ci/gates.json | 44 - .../contracts/registry-baseline.approval.json | 6 +- config/contracts/registry-baseline.json | 342 +----- config/runtime/development.json | 4 +- config/runtime/local.json | 4 +- config/runtime/production.json | 4 +- config/runtime/staging.json | 4 +- config/scale/feature-shape-ceilings.json | 10 +- config/testing/risk-coverage.json | 11 - docs/README.md | 6 +- docs/accessibility/manual-checklist.md | 12 +- .../backend-api-and-server-state-contract.md | 56 +- .../capability-consumer-experience.md | 21 +- docs/architecture/contract-ownership.md | 4 +- .../VD-06-intl-typed-message-catalog.md | 6 +- .../frontend-application-foundation.md | 16 +- .../frontend-ports-adapters-and-boundaries.md | 16 +- docs/architecture/starter-experience.md | 45 +- .../typescript-state-and-data-flow.md | 13 +- docs/contracts/compatibility.md | 2 +- docs/manual/reference/create-feature.md | 9 +- docs/operations/adapter-remediation-ledger.md | 4 +- docs/operations/performance-evidence.md | 18 +- docs/styling/design-tokens.md | 4 +- .../frontend-platform-testing-strategy.md | 9 +- docs/testing/taxonomy.md | 2 +- eslint.config.ts | 14 +- package.json | 3 +- public/config.json | 4 +- public/release-manifest.json | 7 - .../check-browser-file-storage-boundaries.ts | 4 +- scripts/check-i18n.ts | 5 +- scripts/lib/a11y-data-state.ts | 2 +- scripts/lib/feature-residue.ts | 4 +- .../lib}/generated-feature.ts | 58 +- scripts/lib/removable-template-features.ts | 51 +- scripts/lib/removal-fixture.ts | 2 +- scripts/scale/browser-soak.ts | 83 +- scripts/test-sample-removal.ts | 160 +-- scripts/verify-documentation-readiness.ts | 15 +- scripts/verify-extreme-scale.ts | 1 - .../context-module.ts | 12 - .../reference-context/context-module.ts | 10 - .../context-routes.ts | 17 - .../contracts/platform-examples-contract.ts | 82 -- .../platform-examples-message-catalog.ts | 23 - .../feature-module.ts | 27 - .../feature-runtime.ts | 13 - .../presentation/auth-example-page.tsx | 61 - .../presentation/platform-examples-runtime.ts | 17 - .../presentation/state-gallery-page.tsx | 101 -- .../presentation/ui-gallery-page.tsx | 318 ----- src/features/reference-feature/README.md | 92 -- .../create-reference-feature-input.ts | 50 - .../adapters/reference-http-gateway.ts | 92 -- .../application/reference-error.ts | 71 -- .../application/reference-feature-api.ts | 137 --- .../reference-feature/context-routes.ts | 23 - ...reference-feature-contract-contribution.ts | 252 ---- .../contracts/reference-feature-contract.ts | 120 -- .../contracts/reference-mapper.ts | 59 - .../contracts/reference-message-catalog.ts | 112 -- .../contracts/reference-schema-metadata.ts | 63 - .../contracts/reference-schemas.ts | 67 -- .../domain/reference-resource.ts | 14 - .../reference-feature/feature-module.ts | 26 - .../reference-feature/feature-runtime.ts | 18 - .../presentation/reference-feature-runtime.ts | 32 - .../reference-resource-detail-page.tsx | 65 - .../reference-resource-form-page.tsx | 215 ---- .../presentation/reference-resource-form.ts | 29 - .../presentation/reference-resource-page.tsx | 79 -- .../reference-resource-status-page.tsx | 40 - .../presentation/reference-route-codecs.ts | 17 - .../presentation/reference-routes.ts | 37 - .../use-reference-failure-action.ts | 57 - .../presentation/use-reference-feature.ts | 140 --- src/presentation/styles/theme/pages.css | 3 +- tests/component/design-system-links.test.tsx | 12 +- .../component/product-feature-switch.test.tsx | 96 +- tests/e2e/boot-module-failure.spec.ts | 2 +- tests/e2e/generated-feature.spec.ts | 4 +- tests/e2e/old-tab-chunk-recovery.spec.ts | 4 +- tests/e2e/preload-use.spec.ts | 4 +- tests/e2e/reference-form.spec.ts | 150 --- tests/e2e/reference-route.spec.ts | 36 - tests/e2e/reference-save.spec.ts | 237 ---- .../example-pages.test.tsx | 117 -- .../ui-gallery-page.test.tsx | 227 ---- .../reference-feature/feature-module.test.ts | 29 - .../installed-context-routing.test.ts | 39 - .../reference-contract.test.ts | 210 ---- .../reference-diagnostics.test.ts | 68 -- .../reference-feature/reference-error.test.ts | 62 - .../reference-fixture-provenance.test.ts | 37 - .../reference-http-gateway.test.ts | 105 -- .../reference-http-problem-mapping.test.ts | 249 ---- .../reference-installed-executor.test.ts | 55 - .../reference-page-harness.tsx | 109 -- .../reference-feature/reference-page.test.tsx | 1044 ----------------- .../reference-production-vertical.test.tsx | 442 ------- .../reference-request-deduplication.test.ts | 78 -- .../reference-request-fanout.test.ts | 86 -- .../reference-resource-handlers.ts | 57 - .../reference-route-links.test.tsx | 108 -- .../reference-runtime-composition.test.ts | 317 ----- .../reference-telemetry.test.ts | 77 -- .../reference-traffic-kit.ts | 36 - .../reference-traffic-policy.test.ts | 26 - .../reference-validator-protocol.test.ts | 30 - tests/scale/browser-soak.contract.test.ts | 5 +- tests/unit/ci-workflow-generation.test.ts | 8 +- tests/unit/feature-removal-argument.test.ts | 27 + tests/unit/removal-fixture.test.ts | 15 +- ...template-feature-removal-documents.test.ts | 148 ++- tests/unit/vite-build-inputs.test.ts | 28 +- 126 files changed, 630 insertions(+), 7607 deletions(-) delete mode 100644 artifacts/tests/a11y-manual/EXAMPLES_AUTH.md delete mode 100644 artifacts/tests/a11y-manual/EXAMPLES_STATES.md delete mode 100644 artifacts/tests/a11y-manual/EXAMPLES_UI.md delete mode 100644 artifacts/tests/a11y-manual/REFERENCE_RESOURCE_DETAIL.md delete mode 100644 artifacts/tests/a11y-manual/REFERENCE_RESOURCE_FORM.md delete mode 100644 artifacts/tests/a11y-manual/REFERENCE_RESOURCE_LIST.md delete mode 100644 artifacts/tests/a11y-manual/REFERENCE_RESOURCE_STATUS.md rename {tests/e2e/support => scripts/lib}/generated-feature.ts (57%) delete mode 100644 src/contexts/platform-examples-context/context-module.ts delete mode 100644 src/contexts/reference-context/context-module.ts delete mode 100644 src/features/platform-examples-feature/context-routes.ts delete mode 100644 src/features/platform-examples-feature/contracts/platform-examples-contract.ts delete mode 100644 src/features/platform-examples-feature/contracts/platform-examples-message-catalog.ts delete mode 100644 src/features/platform-examples-feature/feature-module.ts delete mode 100644 src/features/platform-examples-feature/feature-runtime.ts delete mode 100644 src/features/platform-examples-feature/presentation/auth-example-page.tsx delete mode 100644 src/features/platform-examples-feature/presentation/platform-examples-runtime.ts delete mode 100644 src/features/platform-examples-feature/presentation/state-gallery-page.tsx delete mode 100644 src/features/platform-examples-feature/presentation/ui-gallery-page.tsx delete mode 100644 src/features/reference-feature/README.md delete mode 100644 src/features/reference-feature/adapters/create-reference-feature-input.ts delete mode 100644 src/features/reference-feature/adapters/reference-http-gateway.ts delete mode 100644 src/features/reference-feature/application/reference-error.ts delete mode 100644 src/features/reference-feature/application/reference-feature-api.ts delete mode 100644 src/features/reference-feature/context-routes.ts delete mode 100644 src/features/reference-feature/contracts/reference-feature-contract-contribution.ts delete mode 100644 src/features/reference-feature/contracts/reference-feature-contract.ts delete mode 100644 src/features/reference-feature/contracts/reference-mapper.ts delete mode 100644 src/features/reference-feature/contracts/reference-message-catalog.ts delete mode 100644 src/features/reference-feature/contracts/reference-schema-metadata.ts delete mode 100644 src/features/reference-feature/contracts/reference-schemas.ts delete mode 100644 src/features/reference-feature/domain/reference-resource.ts delete mode 100644 src/features/reference-feature/feature-module.ts delete mode 100644 src/features/reference-feature/feature-runtime.ts delete mode 100644 src/features/reference-feature/presentation/reference-feature-runtime.ts delete mode 100644 src/features/reference-feature/presentation/reference-resource-detail-page.tsx delete mode 100644 src/features/reference-feature/presentation/reference-resource-form-page.tsx delete mode 100644 src/features/reference-feature/presentation/reference-resource-form.ts delete mode 100644 src/features/reference-feature/presentation/reference-resource-page.tsx delete mode 100644 src/features/reference-feature/presentation/reference-resource-status-page.tsx delete mode 100644 src/features/reference-feature/presentation/reference-route-codecs.ts delete mode 100644 src/features/reference-feature/presentation/reference-routes.ts delete mode 100644 src/features/reference-feature/presentation/use-reference-failure-action.ts delete mode 100644 src/features/reference-feature/presentation/use-reference-feature.ts delete mode 100644 tests/e2e/reference-form.spec.ts delete mode 100644 tests/e2e/reference-route.spec.ts delete mode 100644 tests/e2e/reference-save.spec.ts delete mode 100644 tests/features/platform-examples-feature/example-pages.test.tsx delete mode 100644 tests/features/platform-examples-feature/ui-gallery-page.test.tsx delete mode 100644 tests/features/reference-feature/feature-module.test.ts delete mode 100644 tests/features/reference-feature/installed-context-routing.test.ts delete mode 100644 tests/features/reference-feature/reference-contract.test.ts delete mode 100644 tests/features/reference-feature/reference-diagnostics.test.ts delete mode 100644 tests/features/reference-feature/reference-error.test.ts delete mode 100644 tests/features/reference-feature/reference-fixture-provenance.test.ts delete mode 100644 tests/features/reference-feature/reference-http-gateway.test.ts delete mode 100644 tests/features/reference-feature/reference-http-problem-mapping.test.ts delete mode 100644 tests/features/reference-feature/reference-installed-executor.test.ts delete mode 100644 tests/features/reference-feature/reference-page-harness.tsx delete mode 100644 tests/features/reference-feature/reference-page.test.tsx delete mode 100644 tests/features/reference-feature/reference-production-vertical.test.tsx delete mode 100644 tests/features/reference-feature/reference-request-deduplication.test.ts delete mode 100644 tests/features/reference-feature/reference-request-fanout.test.ts delete mode 100644 tests/features/reference-feature/reference-resource-handlers.ts delete mode 100644 tests/features/reference-feature/reference-route-links.test.tsx delete mode 100644 tests/features/reference-feature/reference-runtime-composition.test.ts delete mode 100644 tests/features/reference-feature/reference-telemetry.test.ts delete mode 100644 tests/features/reference-feature/reference-traffic-kit.ts delete mode 100644 tests/features/reference-feature/reference-traffic-policy.test.ts delete mode 100644 tests/features/reference-feature/reference-validator-protocol.test.ts diff --git a/PRODUCT.md b/PRODUCT.md index 5d612657..d6263b02 100644 --- a/PRODUCT.md +++ b/PRODUCT.md @@ -8,7 +8,7 @@ web ## Users -- **템플릿을 가져다 쓰는 개발자**: 이 템플릿으로 새 서비스를 빠르게 시작하는 사람입니다. 예제 화면(홈, 플랫폼 구성, UI 구성요소, 화면 상태, 인증 연동, Reference feature)은 이 사람이 실행 구조와 공통 동작을 확인하는 용도입니다. +- **템플릿을 가져다 쓰는 개발자**: 이 템플릿으로 새 서비스를 빠르게 시작하는 사람입니다. 기본 화면(홈, 플랫폼 구성)과 Storybook 갤러리(UI 구성요소, 화면 상태)는 이 사람이 실행 구조와 공통 동작을 확인하는 용도입니다. - **파생 서비스의 최종 사용자**: 디자인 시스템(토큰, 프리미티브, 패턴, 레이아웃, 페이지 템플릿)은 이 템플릿으로 만든 서비스를 실제로 쓰는 사람을 기준으로 합니다. ## Product Purpose @@ -30,7 +30,7 @@ web - 하나의 디자인 시스템으로 세 종류의 서비스를 받칩니다. 업무용·관리 도구(대시보드, 어드민, 설정), 일반 사용자용 웹 서비스, 소개·랜딩 페이지입니다. - 디자인 시스템 위치는 `src/presentation/design-system/`입니다. 토큰은 primitive → semantic → component 세 단계로 파생됩니다(`tokens/primitive.css`, `semantic.css`, `component.css`). - 시각 회귀 골든이 `tests/visual/__snapshots__/`에 있습니다. 화면을 바꾸면 골든도 의도적으로 갱신해야 합니다. -- 참조 기능(`src/features/reference-feature/`)은 `test:sample-removal`로 지울 수 있습니다. 예제 화면 3개(`/examples/ui`, `states`, `auth`)도 기능 `platform-examples-feature`라서 같은 드릴(`test:sample-removal -- --feature=platform-examples-feature`)로 지울 수 있습니다. 플랫폼 구성 화면(`/examples/platform`)과 홈은 기본 구성이고 제거 드릴이 없습니다. 그래서 예제 화면 3개에만 넣은 디자인은 예제를 지운 파생 서비스에서 함께 사라지고, 홈과 플랫폼 구성 화면에 넣은 디자인은 남습니다. +- 템플릿에는 샘플 기능이 없습니다(참조 기능과 예제 화면은 2026-11-07에 지웠습니다). 기능은 `create:feature`로 만듭니다. 디자인 시스템 갤러리와 화면 상태 갤러리는 Storybook story(`src/presentation/design-system/galleries.stories.tsx`)이고 시각 회귀 골든의 대상입니다. 플랫폼 구성 화면(`/examples/platform`)과 홈은 기본 구성입니다. 그래서 갤러리와 홈, 플랫폼 구성 화면에 넣은 디자인은 파생 서비스에 남습니다. - 어떤 서비스가 먼저 만들어질지, 서비스별 우선순위는 아직 정하지 않았습니다. ## Brand Commitments diff --git a/README.md b/README.md index f5e039ca..8b0d536b 100644 --- a/README.md +++ b/README.md @@ -87,8 +87,8 @@ persistent `system` / `light` / `dark` theme selector, and a language selector. The route list is `ROUTE_REGISTRY` (`src/features/installed-feature-contracts.ts`): the platform routes of `src/contracts/routes.ts` plus the routes of every -installed feature, the removable reference feature included. The platform -overview page (`/examples/platform`) shows the composed list at runtime, so +installed feature. The template installs none: `corepack pnpm create:feature` +adds one (`docs/manual/`). The platform overview page (`/examples/platform`) shows the composed list at runtime, so this README keeps no copy of it and adding a feature does not edit it. `AUTH_MODE=demo` is credential-free and accepted only in local/development @@ -105,7 +105,7 @@ design documents use; the next table maps them. | Tier | What it covers | Status words | | --- | --- | --- | -| Default | In the default build and covered by the merge gates: the application shell and example routes, the REST HTTP executor, TanStack Query server state, Local/Session Storage registries, cross-tab invalidation, runtime config profiles and the release manifest check, `AUTH_MODE=external` (`demo` only in local/development), the typed message catalog, and the removable reference feature. `dist/` is served by a static host ([`docs/architecture/static-delivery.md`](docs/architecture/static-delivery.md)) | `COMPOSED` | +| Default | In the default build and covered by the merge gates: the application shell and example routes, the REST HTTP executor, TanStack Query server state, Local/Session Storage registries, cross-tab invalidation, runtime config profiles and the release manifest check, `AUTH_MODE=external` (`demo` only in local/development), the typed message catalog, and `create:feature`, which writes a feature that passes the merge gates. `dist/` is served by a static host ([`docs/architecture/static-delivery.md`](docs/architecture/static-delivery.md)) | `COMPOSED` | | Optional (recipe) | Not installed. A project copies one of the recipes in `config/recipes/frontend-capability-recipes.json` and narrows it ([`docs/architecture/optional-adapter-recipes.md`](docs/architecture/optional-adapter-recipes.md)). `realtime`, `offline-indexeddb`, `service-worker-pwa` and `file-transfer` also ship a tested reference runtime that the default build leaves out | `RECIPE_AVAILABLE`, `NOT_INSTALLED`, `AVAILABLE_NOT_COMPOSED` | | Experimental | Designed and decided, but the runtime is missing or unfinished; finish it before building on it. GraphQL, gRPC-Web, Connect-Web and Protobuf adapters, Range resumable download, IndexedDB query persistence, the local preview decode-safety probe | `DESIGNED_NOT_IMPLEMENTED` | | Not supported | Deliberately not selected, or browsers cannot guarantee it: SSR, app-managed background upload and download, directory selection, persistent file handles, product query persistence, exactly-once delivery between tabs | `NOT_SELECTED`, `PLATFORM_LIMITED` | @@ -173,12 +173,13 @@ Domain code lives inside each feature; there is no top-level domain folder. See `docs/architecture/frontend-application-foundation.md`, `docs/architecture/overview.md`, `docs/architecture/layers.md`, and -`docs/architecture/starter-experience.md`. The removable vertical slice is -under `src/features/reference-feature`; its domain, application input, HTTP -binding, contracts, route runtime, and presentation own their contributions. -The central installed catalogs only aggregate selected contributions. The -generic starter routes continue to typecheck, test, and build after that -feature is removed. +`docs/architecture/starter-experience.md`. A feature is a vertical slice under +`src/features/`; its domain, application input, HTTP binding, contracts, +route runtime, and presentation own their contributions. The central installed +catalogs only aggregate selected contributions. The template ships no feature +(its reference sample and example screens were deleted on 2026-11-07): +`corepack pnpm create:feature ` writes one, and the generic starter routes +typecheck, test, and build without any. ### Platform capability review @@ -229,15 +230,15 @@ reads them, except the one file noted below | `CLAUDE.md` | review instructions for the template repository itself; replace it with your own | | `PRODUCT.md` | product context of the template itself (users, purpose, principles) for design tools; replace it with your product's | -The reference feature is not in this list: deleting its directory alone -leaves tests, policy entries and CI scripts behind that fail the gates. -`scripts/test-sample-removal.ts` removes it from a copy of -the repository and lists everything that has to go with it (its header comment, -and the files outside the feature's folders in -`scripts/lib/removable-template-features.ts`); do the same in your project and -run the gates. The documents keep naming the sample's paths: the documentation -check accepts them once `src/features/reference-feature/feature-module.ts` is -gone. +A feature is not in this list: deleting its directory alone leaves tests, +policy entries and CI scripts behind that fail the gates. +`corepack pnpm test:sample-removal -- --feature=` removes it from a copy of +the repository and lists everything that has to go with it (the header comment +of `scripts/test-sample-removal.ts`); do the same in your project and run the +gates. A sample your project keeps for a while can be listed in +`scripts/lib/removable-template-features.ts`: the drill then removes it without +`--feature`, and the documentation check accepts its paths once its +`feature-module.ts` is gone. ## Verification diff --git a/artifacts/tests/a11y-manual/EXAMPLES_AUTH.md b/artifacts/tests/a11y-manual/EXAMPLES_AUTH.md deleted file mode 100644 index 8c6efa23..00000000 --- a/artifacts/tests/a11y-manual/EXAMPLES_AUTH.md +++ /dev/null @@ -1,18 +0,0 @@ -# EXAMPLES_AUTH accessibility review - -Status: pending-manual-review -Route ID: EXAMPLES_AUTH -Release ID: -Reviewer: -Reviewed at: -Signature: -Attestation: pending -M1 Keyboard: pending -M2 Visible focus: pending -M3 Route focus: pending -M4 Modal focus: not-applicable (no modal on this route) -M5 Error association: not-applicable (no form error on this route) -M6 Color signal: pending -M7 Reduced motion: pending -Screen reader: pending -Notes: Review session state announcements and unavailable external-integration behavior. diff --git a/artifacts/tests/a11y-manual/EXAMPLES_STATES.md b/artifacts/tests/a11y-manual/EXAMPLES_STATES.md deleted file mode 100644 index b071073a..00000000 --- a/artifacts/tests/a11y-manual/EXAMPLES_STATES.md +++ /dev/null @@ -1,18 +0,0 @@ -# EXAMPLES_STATES accessibility review - -Status: pending-manual-review -Route ID: EXAMPLES_STATES -Release ID: -Reviewer: -Reviewed at: -Signature: -Attestation: pending -M1 Keyboard: pending -M2 Visible focus: pending -M3 Route focus: pending -M4 Modal focus: not-applicable (no modal on this route) -M5 Error association: not-applicable (no form error on this route) -M6 Color signal: pending -M7 Reduced motion: pending -Screen reader: pending -Notes: Review loading, refresh, empty, error, authentication, forbidden, and not-found announcements. diff --git a/artifacts/tests/a11y-manual/EXAMPLES_UI.md b/artifacts/tests/a11y-manual/EXAMPLES_UI.md deleted file mode 100644 index 6f89235c..00000000 --- a/artifacts/tests/a11y-manual/EXAMPLES_UI.md +++ /dev/null @@ -1,18 +0,0 @@ -# EXAMPLES_UI accessibility review - -Status: pending-manual-review -Route ID: EXAMPLES_UI -Release ID: -Reviewer: -Reviewed at: -Signature: -Attestation: pending -M1 Keyboard: pending -M2 Visible focus: pending -M3 Route focus: pending -M4 Modal focus: pending -M5 Error association: pending -M6 Color signal: pending -M7 Reduced motion: pending -Screen reader: pending -Notes: Review form primitives, Menu/Tabs keyboard behavior, Toast announcements, Tooltip supplemental copy, text-field error association and modal focus containment/restoration. diff --git a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_DETAIL.md b/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_DETAIL.md deleted file mode 100644 index 81ebaae7..00000000 --- a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_DETAIL.md +++ /dev/null @@ -1,18 +0,0 @@ -# REFERENCE_RESOURCE_DETAIL accessibility review - -Status: pending-manual-review -Route ID: REFERENCE_RESOURCE_DETAIL -Release ID: -Reviewer: -Reviewed at: -Signature: -Attestation: pending -M1 Keyboard: pending -M2 Visible focus: pending -M3 Route focus: pending -M4 Modal focus: not-applicable (no modal on this route) -M5 Error association: not-applicable (no form error on this route) -M6 Color signal: pending -M7 Reduced motion: pending -Screen reader: pending -Notes: Human review pending. diff --git a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_FORM.md b/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_FORM.md deleted file mode 100644 index e78d1859..00000000 --- a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_FORM.md +++ /dev/null @@ -1,18 +0,0 @@ -# REFERENCE_RESOURCE_FORM accessibility review - -Status: pending-manual-review -Route ID: REFERENCE_RESOURCE_FORM -Release ID: -Reviewer: -Reviewed at: -Signature: -Attestation: pending -M1 Keyboard: pending -M2 Visible focus: pending -M3 Route focus: pending -M4 Modal focus: pending -M5 Error association: pending -M6 Color signal: pending -M7 Reduced motion: pending -Screen reader: pending -Notes: Human review pending. diff --git a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_LIST.md b/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_LIST.md deleted file mode 100644 index 74e9ae65..00000000 --- a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_LIST.md +++ /dev/null @@ -1,18 +0,0 @@ -# REFERENCE_RESOURCE_LIST accessibility review - -Status: pending-manual-review -Route ID: REFERENCE_RESOURCE_LIST -Release ID: -Reviewer: -Reviewed at: -Signature: -Attestation: pending -M1 Keyboard: pending -M2 Visible focus: pending -M3 Route focus: pending -M4 Modal focus: not-applicable (no modal on this route) -M5 Error association: not-applicable (no form error on this route) -M6 Color signal: pending -M7 Reduced motion: pending -Screen reader: pending -Notes: Human review pending. diff --git a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_STATUS.md b/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_STATUS.md deleted file mode 100644 index 93e37c45..00000000 --- a/artifacts/tests/a11y-manual/REFERENCE_RESOURCE_STATUS.md +++ /dev/null @@ -1,18 +0,0 @@ -# REFERENCE_RESOURCE_STATUS accessibility review - -Status: pending-manual-review -Route ID: REFERENCE_RESOURCE_STATUS -Release ID: -Reviewer: -Reviewed at: -Signature: -Attestation: pending -M1 Keyboard: pending -M2 Visible focus: pending -M3 Route focus: pending -M4 Modal focus: not-applicable (no modal on this route) -M5 Error association: not-applicable (no form error on this route) -M6 Color signal: pending -M7 Reduced motion: pending -Screen reader: pending -Notes: Human review pending. diff --git a/config/ci/contract-baseline.json b/config/ci/contract-baseline.json index 7e1243d0..439cde3c 100644 --- a/config/ci/contract-baseline.json +++ b/config/ci/contract-baseline.json @@ -1,11 +1,11 @@ { "schemaVersion": 1, "owner": "DongHyeonka", - "reason": "1106/13-01: FE-GATE-027 runs the advisory scan before the release admission", + "reason": "2026-11-07 소유자 결정: 템플릿 샘플 삭제. 참조 기능 시험 명령과 그 산출물, 지운 라우트의 수동 a11y 기록 산출물 4개를 뺀다", "gates": 27, - "commands": 100, - "commandReferences": 104, - "artifacts": 110, + "commands": 99, + "commandReferences": 103, + "artifacts": 105, "stages": 5, - "gateShapeSha256": "7f6f3d975c62c022d6a6f8b5f39562f73de9ca0f22aa3d086ac28959e50fa93e" + "gateShapeSha256": "df584fba26f8448c6a77638351c6906ed91869da82e20f12ac71ea7b2037c989" } diff --git a/config/ci/gates.json b/config/ci/gates.json index 500fca74..bb90e7c2 100644 --- a/config/ci/gates.json +++ b/config/ci/gates.json @@ -238,11 +238,6 @@ "script": "test:http-scenario-evidence", "expect": "pass" }, - { - "id": "test-reference-feature", - "script": "test:reference-feature", - "expect": "pass" - }, { "id": "test-recipes", "script": "test:recipes", @@ -1028,15 +1023,6 @@ "test-http-scenario-evidence" ] }, - { - "id": "artifact-artifacts-tests-reference-feature-xml", - "path": "artifacts/tests/reference-feature.xml", - "schemaId": "junit", - "production": "command-generated", - "producerCommandIds": [ - "test-reference-feature" - ] - }, { "id": "artifact-artifacts-tests-optional-recipes-xml", "path": "artifacts/tests/optional-recipes.xml", @@ -1163,30 +1149,6 @@ "schemaId": "markdown", "production": "source-controlled" }, - { - "id": "artifact-artifacts-tests-a11y-manual-EXAMPLES-UI-md", - "path": "artifacts/tests/a11y-manual/EXAMPLES_UI.md", - "schemaId": "markdown", - "production": "source-controlled" - }, - { - "id": "artifact-artifacts-tests-a11y-manual-EXAMPLES-STATES-md", - "path": "artifacts/tests/a11y-manual/EXAMPLES_STATES.md", - "schemaId": "markdown", - "production": "source-controlled" - }, - { - "id": "artifact-artifacts-tests-a11y-manual-EXAMPLES-AUTH-md", - "path": "artifacts/tests/a11y-manual/EXAMPLES_AUTH.md", - "schemaId": "markdown", - "production": "source-controlled" - }, - { - "id": "artifact-artifacts-tests-a11y-manual-REFERENCE-RESOURCE-LIST-md", - "path": "artifacts/tests/a11y-manual/REFERENCE_RESOURCE_LIST.md", - "schemaId": "markdown", - "production": "source-controlled" - }, { "id": "artifact-artifacts-tests-a11y-manual-NOT-FOUND-md", "path": "artifacts/tests/a11y-manual/NOT_FOUND.md", @@ -1875,7 +1837,6 @@ "commandIds": [ "test-integration", "test-http-scenario-evidence", - "test-reference-feature", "test-recipes" ], "logArtifactId": "artifact-artifacts-quality-gates-FE-GATE-007-txt", @@ -1884,7 +1845,6 @@ "artifact-artifacts-tests-http-scenario-executions-json", "artifact-artifacts-quality-http-scenario-evidence-json", "artifact-artifacts-quality-http-scenario-evidence-fixture-json", - "artifact-artifacts-tests-reference-feature-xml", "artifact-artifacts-tests-optional-recipes-xml" ], "retentionClassId": "merge-cycle" @@ -2227,10 +2187,6 @@ "logArtifactId": "artifact-artifacts-quality-gates-FE-GATE-028-txt", "evidenceArtifactIds": [ "artifact-artifacts-tests-a11y-manual-APP-HOME-md", - "artifact-artifacts-tests-a11y-manual-EXAMPLES-UI-md", - "artifact-artifacts-tests-a11y-manual-EXAMPLES-STATES-md", - "artifact-artifacts-tests-a11y-manual-EXAMPLES-AUTH-md", - "artifact-artifacts-tests-a11y-manual-REFERENCE-RESOURCE-LIST-md", "artifact-artifacts-tests-a11y-manual-NOT-FOUND-md", "artifact-artifacts-tests-a11y-manual-report-json" ], diff --git a/config/contracts/registry-baseline.approval.json b/config/contracts/registry-baseline.approval.json index 74247c76..3ffa6989 100644 --- a/config/contracts/registry-baseline.approval.json +++ b/config/contracts/registry-baseline.approval.json @@ -1,7 +1,7 @@ { "schemaVersion": 1, - "snapshotDigest": "319a798ca3c9a87d7e2943177d952b13941622f4faec23c28f36024196a9e91d", + "snapshotDigest": "2430864767622f21490feb7f0b6932f73b82c0062e4b3ec70fe2c3ef3ac76889", "owner": "DongHyeonka", - "reason": "1103/16-04 FE-REG-API problemSchema가 FE-REG-SCHEMA api-problem 행을 참조한다", - "approvedAt": "2026-11-04T14:04:44.377Z" + "reason": "2026-11-07 소유자 결정: 템플릿 샘플 삭제(design-docs repo-structure/README.md 3.4절). 참조 기능과 예제 화면의 라우트·operation·스키마·무효화 행을 지운다", + "approvedAt": "2026-11-08T02:26:50.112Z" } diff --git a/config/contracts/registry-baseline.json b/config/contracts/registry-baseline.json index 6a56a3ef..a054a8b4 100644 --- a/config/contracts/registry-baseline.json +++ b/config/contracts/registry-baseline.json @@ -5,7 +5,7 @@ "registryId": "FE-REG-ROUTE", "owner": "feature-frontend-routing-release-recovery-runtime", "source": "src/features/installed-feature-contracts.ts", - "rowCount": 10, + "rowCount": 3, "contract": { "requiredFields": [ "routeId", @@ -93,19 +93,6 @@ "searchSchema": null, "title": "시작" }, - "EXAMPLES_AUTH": { - "access": "public", - "chunkId": "route-examples-auth", - "errorSurface": "route-boundary", - "loadingSurface": "example-page", - "navigationLabel": "인증 연동", - "navigationOrder": 40, - "paramsSchema": null, - "path": "/examples/auth", - "routeId": "EXAMPLES_AUTH", - "searchSchema": null, - "title": "인증 연동" - }, "EXAMPLES_PLATFORM": { "access": "public", "chunkId": "route-examples-platform", @@ -119,32 +106,6 @@ "searchSchema": null, "title": "플랫폼 구성" }, - "EXAMPLES_STATES": { - "access": "public", - "chunkId": "route-examples-states", - "errorSurface": "route-boundary", - "loadingSurface": "example-page", - "navigationLabel": "화면 상태", - "navigationOrder": 30, - "paramsSchema": null, - "path": "/examples/states", - "routeId": "EXAMPLES_STATES", - "searchSchema": null, - "title": "화면 상태" - }, - "EXAMPLES_UI": { - "access": "public", - "chunkId": "route-examples-ui", - "errorSurface": "route-boundary", - "loadingSurface": "example-page", - "navigationLabel": "UI 구성요소", - "navigationOrder": 20, - "paramsSchema": null, - "path": "/examples/ui", - "routeId": "EXAMPLES_UI", - "searchSchema": null, - "title": "UI 구성요소" - }, "NOT_FOUND": { "access": "public", "chunkId": "route-not-found", @@ -157,58 +118,6 @@ "routeId": "NOT_FOUND", "searchSchema": null, "title": "페이지를 찾을 수 없음" - }, - "REFERENCE_RESOURCE_DETAIL": { - "access": "session-required", - "chunkId": "route-reference-resource-detail", - "errorSurface": "feature-boundary", - "loadingSurface": "reference-resource-detail", - "navigationLabel": null, - "navigationOrder": null, - "paramsSchema": "ReferenceResourceParams", - "path": "/examples/reference-resources/items/:resourceId", - "routeId": "REFERENCE_RESOURCE_DETAIL", - "searchSchema": null, - "title": "Reference detail" - }, - "REFERENCE_RESOURCE_FORM": { - "access": "session-required", - "chunkId": "route-reference-resource-form", - "errorSurface": "feature-boundary", - "loadingSurface": "reference-resource-form", - "navigationLabel": null, - "navigationOrder": null, - "paramsSchema": null, - "path": "/examples/reference-resources/new", - "routeId": "REFERENCE_RESOURCE_FORM", - "searchSchema": null, - "title": "Reference form" - }, - "REFERENCE_RESOURCE_LIST": { - "access": "session-required", - "chunkId": "route-reference-resources", - "errorSurface": "feature-boundary", - "loadingSurface": "reference-resource-list", - "navigationLabel": "Reference feature", - "navigationOrder": 50, - "paramsSchema": null, - "path": "/examples/reference-resources", - "routeId": "REFERENCE_RESOURCE_LIST", - "searchSchema": "ReferenceResourceListQuery", - "title": "Reference feature" - }, - "REFERENCE_RESOURCE_STATUS": { - "access": "session-required", - "chunkId": "route-reference-resource-status", - "errorSurface": "feature-boundary", - "loadingSurface": "reference-resource-status", - "navigationLabel": null, - "navigationOrder": null, - "paramsSchema": null, - "path": "/examples/reference-resources/status", - "routeId": "REFERENCE_RESOURCE_STATUS", - "searchSchema": null, - "title": "Reference status" } } }, @@ -216,7 +125,7 @@ "registryId": "FE-REG-ROUTE-RUNTIME", "owner": "feature-frontend-routing-release-recovery-runtime", "source": "src/features/installed-feature-contracts.ts", - "rowCount": 10, + "rowCount": 3, "contract": { "requiredFields": [ "routeId", @@ -267,59 +176,17 @@ "routeId": "APP_HOME", "searchCodec": "none" }, - "EXAMPLES_AUTH": { - "moduleId": "auth-example-page", - "paramsCodec": "none", - "routeId": "EXAMPLES_AUTH", - "searchCodec": "none" - }, "EXAMPLES_PLATFORM": { "moduleId": "platform-overview-page", "paramsCodec": "none", "routeId": "EXAMPLES_PLATFORM", "searchCodec": "none" }, - "EXAMPLES_STATES": { - "moduleId": "state-gallery-page", - "paramsCodec": "none", - "routeId": "EXAMPLES_STATES", - "searchCodec": "none" - }, - "EXAMPLES_UI": { - "moduleId": "ui-gallery-page", - "paramsCodec": "none", - "routeId": "EXAMPLES_UI", - "searchCodec": "none" - }, "NOT_FOUND": { "moduleId": "not-found-page", "paramsCodec": "NotFoundSplat", "routeId": "NOT_FOUND", "searchCodec": "none" - }, - "REFERENCE_RESOURCE_DETAIL": { - "moduleId": "reference-resource-detail-page", - "paramsCodec": "ReferenceResourceParams", - "routeId": "REFERENCE_RESOURCE_DETAIL", - "searchCodec": "none" - }, - "REFERENCE_RESOURCE_FORM": { - "moduleId": "reference-resource-form-page", - "paramsCodec": "none", - "routeId": "REFERENCE_RESOURCE_FORM", - "searchCodec": "none" - }, - "REFERENCE_RESOURCE_LIST": { - "moduleId": "reference-resource-page", - "paramsCodec": "none", - "routeId": "REFERENCE_RESOURCE_LIST", - "searchCodec": "ReferenceResourceListQuery" - }, - "REFERENCE_RESOURCE_STATUS": { - "moduleId": "reference-resource-status-page", - "paramsCodec": "none", - "routeId": "REFERENCE_RESOURCE_STATUS", - "searchCodec": "none" } } }, @@ -327,7 +194,7 @@ "registryId": "FE-REG-API", "owner": "feature-frontend-api-client-response-envelope-contract", "source": "src/features/loaded-feature-runtimes.ts", - "rowCount": 3, + "rowCount": 0, "contract": { "requiredFields": [ "operationId", @@ -442,113 +309,13 @@ "unvalidated" ] }, - "rows": { - "CREATE_REFERENCE_RESOURCE": { - "acceptedStatuses": [ - 200, - 201 - ], - "authProfileId": "EXTERNAL_BEARER", - "commandEffect": { - "classifiesStatus": true - }, - "commandRecovery": { - "mode": "IDEMPOTENCY_REPLAY", - "operationIdentityField": "idempotencyKey" - }, - "emptyBodyStatuses": [], - "featureId": "reference-feature", - "method": "POST", - "operationId": "CREATE_REFERENCE_RESOURCE", - "path": "/api/reference-resources", - "problemSchema": "ReferenceProblem", - "requestBody": "JSON", - "requestByteLimit": 32768, - "requestSchema": "CreateReferenceResourceCommand", - "responseBody": "REQUIRED_JSON", - "responseByteLimit": 32768, - "responseEnvelope": "NONE", - "responseSchema": "ReferenceResourcePayload", - "retryBudget": 0, - "retrySemantics": "KEYED", - "totalDeadlineMs": 10000, - "traffic": { - "maxConcurrentRequests": 1, - "maxPhysicalRequests": 1, - "maxQueuedRequests": 0, - "maxRetries": 0 - }, - "unvalidated": [] - }, - "GET_REFERENCE_RESOURCE": { - "acceptedStatuses": [ - 200 - ], - "authProfileId": "EXTERNAL_BEARER", - "commandEffect": null, - "commandRecovery": null, - "emptyBodyStatuses": [], - "featureId": "reference-feature", - "method": "GET", - "operationId": "GET_REFERENCE_RESOURCE", - "path": "/api/reference-resources/{resourceId}", - "problemSchema": "ReferenceProblem", - "requestBody": "NONE", - "requestByteLimit": 0, - "requestSchema": "ReferenceResourceParams", - "responseBody": "REQUIRED_JSON", - "responseByteLimit": 32768, - "responseEnvelope": "NONE", - "responseSchema": "ReferenceResourcePayload", - "retryBudget": 2, - "retrySemantics": "SAFE", - "totalDeadlineMs": 10000, - "traffic": { - "maxConcurrentRequests": 1, - "maxPhysicalRequests": 3, - "maxQueuedRequests": 0, - "maxRetries": 2 - }, - "unvalidated": [] - }, - "LIST_REFERENCE_RESOURCES": { - "acceptedStatuses": [ - 200 - ], - "authProfileId": "EXTERNAL_BEARER", - "commandEffect": null, - "commandRecovery": null, - "emptyBodyStatuses": [], - "featureId": "reference-feature", - "method": "GET", - "operationId": "LIST_REFERENCE_RESOURCES", - "path": "/api/reference-resources", - "problemSchema": "ReferenceProblem", - "requestBody": "NONE", - "requestByteLimit": 0, - "requestSchema": "ReferenceResourceListQuery", - "responseBody": "REQUIRED_JSON", - "responseByteLimit": 262144, - "responseEnvelope": "NONE", - "responseSchema": "ReferenceResourceListPayload", - "retryBudget": 2, - "retrySemantics": "SAFE", - "totalDeadlineMs": 10000, - "traffic": { - "maxConcurrentRequests": 1, - "maxPhysicalRequests": 3, - "maxQueuedRequests": 0, - "maxRetries": 2 - }, - "unvalidated": [] - } - } + "rows": {} }, { "registryId": "FE-REG-SCHEMA", "owner": "feature-frontend-contract-schema-registry", "source": "src/features/loaded-feature-runtimes.ts", - "rowCount": 8, + "rowCount": 2, "contract": { "requiredFields": [ "schemaId", @@ -587,15 +354,6 @@ ] }, "rows": { - "CreateReferenceResourceCommand": { - "boundary": "api-request", - "direction": "REQUEST", - "owner": "feature-frontend-reference-feature-vertical-slice", - "runtime": "zod", - "schemaId": "CreateReferenceResourceCommand", - "schemaVersion": 1, - "unknownFieldPolicy": "REJECT_UNKNOWN" - }, "none": { "boundary": "route-params", "owner": "feature-frontend-routing-release-recovery-runtime", @@ -607,51 +365,6 @@ "owner": "feature-frontend-routing-release-recovery-runtime", "runtime": "zod", "schemaId": "NotFoundSplat" - }, - "ReferenceProblem": { - "boundary": "api-problem", - "direction": "RESPONSE", - "owner": "feature-frontend-reference-feature-vertical-slice", - "runtime": "zod", - "schemaId": "ReferenceProblem", - "schemaVersion": 1, - "unknownFieldPolicy": "STRIP_UNKNOWN" - }, - "ReferenceResourceListPayload": { - "boundary": "api-response", - "direction": "RESPONSE", - "owner": "feature-frontend-reference-feature-vertical-slice", - "runtime": "zod", - "schemaId": "ReferenceResourceListPayload", - "schemaVersion": 1, - "unknownFieldPolicy": "STRIP_UNKNOWN" - }, - "ReferenceResourceListQuery": { - "boundary": "route-search-api-request", - "direction": "REQUEST", - "owner": "feature-frontend-reference-feature-vertical-slice", - "runtime": "zod", - "schemaId": "ReferenceResourceListQuery", - "schemaVersion": 1, - "unknownFieldPolicy": "REJECT_UNKNOWN" - }, - "ReferenceResourceParams": { - "boundary": "route-params", - "direction": "REQUEST", - "owner": "feature-frontend-reference-feature-vertical-slice", - "runtime": "zod", - "schemaId": "ReferenceResourceParams", - "schemaVersion": 1, - "unknownFieldPolicy": "REJECT_UNKNOWN" - }, - "ReferenceResourcePayload": { - "boundary": "api-response", - "direction": "RESPONSE", - "owner": "feature-frontend-reference-feature-vertical-slice", - "runtime": "zod", - "schemaId": "ReferenceResourcePayload", - "schemaVersion": 1, - "unknownFieldPolicy": "STRIP_UNKNOWN" } } }, @@ -814,7 +527,7 @@ "registryId": "FE-REG-STORAGE", "owner": "feature-frontend-storage-registry-contract", "source": "src/contracts/storage-keys.ts", - "rowCount": 7, + "rowCount": 8, "contract": { "requiredFields": [ "logicalName", @@ -883,6 +596,19 @@ ] }, "rows": { + "AUTH_REDIRECT_TRANSACTION": { + "backend": "external", + "classification": "opaque-cache", + "logicalName": "AUTH_REDIRECT_TRANSACTION", + "migration": "discard", + "name": "oidc-pkce-transaction", + "physicalKey": "ca-frontend:auth:v1:oidc-pkce-transaction", + "quotaFallback": "no-persist", + "schemaVersion": 1, + "scope": "auth", + "ttl": "session", + "valueCodec": "none" + }, "AUTH_TOKEN": { "backend": "forbidden", "classification": "sensitive-forbidden", @@ -1304,24 +1030,9 @@ }, "rows": { "invalidation-graph": { - "edges": [ - { - "namespace": { - "namespaceId": "reference-resource", - "namespaceVersion": 1 - }, - "topicId": "qinv.01k10f7m3w9p6r2c8v5n4x" - } - ], - "namespaces": [ - { - "namespaceId": "reference-resource", - "namespaceVersion": 1 - } - ], - "topics": [ - "qinv.01k10f7m3w9p6r2c8v5n4x" - ] + "edges": [], + "namespaces": [], + "topics": [] } } }, @@ -1329,7 +1040,7 @@ "registryId": "FE-REG-QUERY-INVALIDATION-TOPIC-VERSION", "owner": "feature-frontend-server-state-caching-contract", "source": "src/features/installed-feature-contracts.ts", - "rowCount": 1, + "rowCount": 0, "contract": { "requiredFields": [ "topicId", @@ -1353,12 +1064,7 @@ "topicId" ] }, - "rows": { - "[\"qinv.01k10f7m3w9p6r2c8v5n4x\"]": { - "topicId": "qinv.01k10f7m3w9p6r2c8v5n4x", - "topicVersion": 1 - } - } + "rows": {} }, { "registryId": "FE-REG-TELEMETRY", diff --git a/config/runtime/development.json b/config/runtime/development.json index 63006b82..d73619fc 100644 --- a/config/runtime/development.json +++ b/config/runtime/development.json @@ -13,7 +13,5 @@ "SERVICE_WORKER": "DEFAULT", "OFFLINE_COMMANDS": "DEFAULT" }, - "FEATURE_OVERRIDES": { - "reference-feature": "DEFAULT" - } + "FEATURE_OVERRIDES": {} } diff --git a/config/runtime/local.json b/config/runtime/local.json index 952aa3c9..6222d0b6 100644 --- a/config/runtime/local.json +++ b/config/runtime/local.json @@ -13,7 +13,5 @@ "SERVICE_WORKER": "DEFAULT", "OFFLINE_COMMANDS": "DEFAULT" }, - "FEATURE_OVERRIDES": { - "reference-feature": "DEFAULT" - } + "FEATURE_OVERRIDES": {} } diff --git a/config/runtime/production.json b/config/runtime/production.json index 46ad7781..a6ee567d 100644 --- a/config/runtime/production.json +++ b/config/runtime/production.json @@ -14,7 +14,5 @@ "SERVICE_WORKER": "DEFAULT", "OFFLINE_COMMANDS": "DEFAULT" }, - "FEATURE_OVERRIDES": { - "reference-feature": "DEFAULT" - } + "FEATURE_OVERRIDES": {} } diff --git a/config/runtime/staging.json b/config/runtime/staging.json index 861f87bd..f1df1789 100644 --- a/config/runtime/staging.json +++ b/config/runtime/staging.json @@ -14,7 +14,5 @@ "SERVICE_WORKER": "DEFAULT", "OFFLINE_COMMANDS": "DEFAULT" }, - "FEATURE_OVERRIDES": { - "reference-feature": "DEFAULT" - } + "FEATURE_OVERRIDES": {} } diff --git a/config/scale/feature-shape-ceilings.json b/config/scale/feature-shape-ceilings.json index b5cd3fdf..ebb04405 100644 --- a/config/scale/feature-shape-ceilings.json +++ b/config/scale/feature-shape-ceilings.json @@ -39,10 +39,10 @@ } ], "initialJavascript": { - "gzipBytes": 204266, - "files": 27, - "firstFeatureGzipBytes": 797, - "perFeatureGzipBytes": 521, - "perContextGzipBytes": 12 + "gzipBytes": 194354, + "files": 17, + "firstFeatureGzipBytes": 6327, + "perFeatureGzipBytes": 539, + "perContextGzipBytes": 4 } } diff --git a/config/testing/risk-coverage.json b/config/testing/risk-coverage.json index 0ba7859c..3cf507f8 100644 --- a/config/testing/risk-coverage.json +++ b/config/testing/risk-coverage.json @@ -129,16 +129,6 @@ "branches": 58 } }, - { - "path": "src/features/reference-feature/adapters/reference-http-gateway.ts", - "owner": "reference-feature", - "minimum": { - "lines": 90, - "statements": 90, - "functions": 90, - "branches": 90 - } - }, { "path": "src/presentation/adapters/query/application-query.ts", "owner": "presentation-runtime", @@ -193,7 +183,6 @@ "src/bootstrap/load-release-manifest.ts", "src/bootstrap/read-bounded-boot-json.ts", "src/contracts/diagnostics.ts", - "src/features/reference-feature/adapters/reference-http-gateway.ts", "src/presentation/adapters/query/application-query.ts", "src/adapters/http/http-contract-bridge.ts", "src/adapters/http/http-retry-lifecycle.ts", diff --git a/docs/README.md b/docs/README.md index 74dc482b..fc22ea81 100644 --- a/docs/README.md +++ b/docs/README.md @@ -51,9 +51,9 @@ checkout이 없거나 그 커밋이 없으면 실패 대신 확인하지 못한 지난 상태를 적는 문서라 빼고, git이 무시하는 생성 산출물과 복사한 프로젝트가 지운 작업 이력은 없어도 된다. 설명·수치가 코드와 맞는지는 검사하지 않는다. 규칙과 예외의 정본은 `scripts/verify-documentation-readiness.ts`다. -복사한 프로젝트가 지울 수 있는 템플릿 기능(참조 기능, 예제 화면. 목록은 -`scripts/lib/removable-template-features.ts`)의 경로와 script는 그 기능이 설치돼 있을 때 -(`src/features//feature-module.ts`가 있을 때) 검사하고, 지운 뒤에는 없어도 된다. +프로젝트가 지울 예정인 샘플 기능(목록은 `scripts/lib/removable-template-features.ts`, 템플릿은 +비어 있다)의 경로와 script는 그 기능이 설치돼 있을 때(`src/features//feature-module.ts`가 +있을 때) 검사하고, 지운 뒤에는 없어도 된다. 게이트가 직접 읽는 파일이라 지우거나 옮기면 게이트가 실패한다. diff --git a/docs/accessibility/manual-checklist.md b/docs/accessibility/manual-checklist.md index 61425334..313cd9b8 100644 --- a/docs/accessibility/manual-checklist.md +++ b/docs/accessibility/manual-checklist.md @@ -57,8 +57,8 @@ The reviewer must verify: - M7: non-essential motion is suppressed with reduced-motion preference - Screen reader: headings, live regions, errors, and actions are announced once -`EXAMPLES_UI` requires real M4 modal and M5 field-error review; those items must -not be marked not-applicable on that route. Passing automated evidence means +A route with a form or a dialog requires real M4 modal and M5 field-error +review; those items must not be marked not-applicable on that route. Passing automated evidence means only that tested pages had no critical or serious axe findings under the recorded Chromium, Firefox, and WebKit runs. @@ -78,7 +78,7 @@ What the automated run scans: route's `paramsSchema` is the input of such a read, the report expects that record from the descriptors alone and fails without it (`scripts/write-a11y-report.ts`). -- The reference sample's list in its success, empty and error states, its - detail, its form with submit errors and its status page, each after that - state is on screen (`tests/e2e/reference-form.spec.ts`, removed with the - sample). +- The list of the feature `create:feature` writes, in its success, empty and + error states, its detail and its form with submit errors, each after that + state is on screen (`tests/e2e/generated-feature.spec.ts`, on a build with + that feature). A product's own features get the route scan above. diff --git a/docs/architecture/backend-api-and-server-state-contract.md b/docs/architecture/backend-api-and-server-state-contract.md index f6131c85..8f267acc 100644 --- a/docs/architecture/backend-api-and-server-state-contract.md +++ b/docs/architecture/backend-api-and-server-state-contract.md @@ -124,36 +124,22 @@ runtime config의 version 문자열 일치만 compatibility 증거로 사용하 artifact digest가 없는 동안에는 실제 staging conformance fixture와 수동 승인 evidence가 필요하다. -## 4. 현재 reference REST 계약 +## 4. 현재 REST 계약 -현재 frontend에 실제 조립된 operation은 다음 세 개다. +템플릿에는 조립된 기능 operation이 없다. 참조 샘플(`LIST_REFERENCE_RESOURCES` 등 +problem details 모양의 세 operation)은 2026-11-07에 지웠다. 기능의 operation은 +`corepack pnpm create:feature `가 만든다. 짝 백엔드 `new-feature.sh`와 같은 경로 +규칙이다(`docs/manual/reference/create-feature.md`). | operation | request | success | | --- | --- | --- | -| `LIST_REFERENCE_RESOURCES` | `GET /api/reference-resources?cursor&limit&tags` | `200 application/json` | -| `GET_REFERENCE_RESOURCE` | `GET /api/reference-resources/{resourceId}` | `200 application/json` | -| `CREATE_REFERENCE_RESOURCE` | `POST /api/reference-resources` | `200` 또는 `201 application/json` | +| `_LIST_ITEMS` | `GET /` | `200`, Envelope 안의 항목 배열과 `meta.page` | +| `_GET_ITEM` (`--with-create`) | `GET //{Id}` | `200`, Envelope 안의 항목 | +| `_CREATE_ITEM` (`--with-create`) | `POST /` | `201`, Envelope 안의 항목 | -현재 list payload는 `ReferenceResource[]`다. `cursor` 입력이 존재하더라도 -`CursorPage` 출력 계약은 아직 아니다. backend가 같은 operation에서 배열을 -page object로 조용히 바꾸면 schema mismatch로 실패한다. - -resource DTO: - -```text -ReferenceResourceDtoV1 - id: non-empty string, maximum 120 characters - name: non-empty string, maximum 240 characters - createdAt?: RFC 3339 date-time -``` - -create command: - -```text -CreateReferenceResourceCommandV1 - name: trimmed string, 1..120 - note?: trimmed string, 0..500 -``` +모든 operation이 `responseEnvelope: "ENVELOPE_V1"`이다. Envelope가 없는 백엔드(DTO와 +problem details)에 붙이는 법은 [매뉴얼 02 결정표 4절](../manual/02-decision-tables.md)의 +「problem details 백엔드의 예」다. Backend는 frontend validation을 신뢰하지 않고 동일하거나 더 좁은 validation과 authorization을 다시 수행한다. @@ -193,8 +179,9 @@ Envelope의 모양과 키 존재 규칙은 짝 백엔드 템플릿 문서가 정 바뀐 파일마다 다시 볼 프론트 위치를 말하며 1로 끝난다(1105/16-02). - 프론트에서 Envelope를 읽는 곳: `src/adapters/http/backend-envelope.ts`(스키마와 해석). V3 실행기는 descriptor가 `responseEnvelope: "ENVELOPE_V1"`일 때 쓴다. - `create:feature`가 만든 기능은 이 값을 선언한다. 참조 기능은 `"NONE"`을 - 선언하고 DTO와 problem details를 검증한다. 이 칸은 descriptor 타입의 필수 + `create:feature`가 만든 기능은 이 값을 선언한다. Envelope가 없는 백엔드의 + operation은 `"NONE"`을 선언하고 DTO와 problem details를 검증한다(매뉴얼 02 + 결정표 4절의 예). 이 칸은 descriptor 타입의 필수 칸이라 빠뜨리면 `check:types`가 실패한다(1103/16-01). - 실패 Envelope의 `error.code`가 "적용 안 됨"인지는 6.1절이 정한다. - 페이지 목록의 `meta.page`(`number`·`size`·`total`·`sort`)는 기능의 @@ -272,7 +259,7 @@ Cross-origin bearer provider 최소 CORS: ## 6. Command와 idempotency -`CREATE_REFERENCE_RESOURCE`는 keyed command다. frontend memory single-flight는 +`create:feature --with-create --keyed`의 작성 operation은 keyed command다. frontend memory single-flight는 backend idempotency를 대체하지 않는다. 멱등성 응답의 status·`error.code`·`retryable`·`Retry-After`와 키 문법은 짝 @@ -287,9 +274,8 @@ backend idempotency를 대체하지 않는다. `src/presentation/adapters/query/application-query.ts` - Envelope operation의 거절 판정: `src/adapters/http/backend-envelope.ts` `REFUSED_BEFORE_WRITE`(6.1절 표) - - 참조 기능(Envelope 없음) 판정: `src/features/reference-feature/contracts/reference-feature-contract-contribution.ts` - (effect), `src/features/reference-feature/adapters/reference-http-gateway.ts` - (code) + - Envelope 없는 operation의 판정: 기능의 `commandEffect.classifyProblem`과 + `mapProblem`(예: [매뉴얼 02 결정표 4절](../manual/02-decision-tables.md)의 코드 조각) ### 6.1 거절 code와 적용 여부 @@ -411,10 +397,10 @@ mutation이 400·409·422로 실패하면 프론트는 그 요청이 적용됐 프론트 판정과 표가 다른 곳(고치면 이 줄을 지운다): -- 참조 기능 분류기(`classifyProblem`)는 참조 fixture(problem+json)용이라 - 400·422를 모두 `NOT_APPLIED`로 본다. 참조 기능은 Envelope operation이 아니라 - 이 표의 대상이 아니다. 짝 백엔드에 붙이는 Envelope operation은 - `src/adapters/http/backend-envelope.ts`의 표가 400·409·422를 정한다(`3261208`). +- 매뉴얼 02 결정표의 problem details 예(`classifyProblem`)는 400·422를 모두 + `NOT_APPLIED`로 본다. Envelope operation이 아니라 이 표의 대상이 아니다. 짝 + 백엔드에 붙이는 Envelope operation은 `src/adapters/http/backend-envelope.ts`의 + 표가 400·409·422를 정한다(`3261208`). 남은 위험: "쓰기 전"은 현재 코드에서 그 handler에 닿는 출처를 센 결과다. 백엔드가 application bean에 `@Validated`를 달거나 JPA entity에 Bean Validation 제약을 diff --git a/docs/architecture/capability-consumer-experience.md b/docs/architecture/capability-consumer-experience.md index 18033b4d..422fbc66 100644 --- a/docs/architecture/capability-consumer-experience.md +++ b/docs/architecture/capability-consumer-experience.md @@ -8,23 +8,24 @@ These measurements are baselines, not score targets. A lower line count is not automatically better if it hides business semantics or creates a universal repository abstraction. -## Scenario A — reference REST feature +## Scenario A — a REST feature -The existing reference feature is the executable REST consumer. +The REST consumer is the feature `corepack pnpm create:feature --with-create` +writes (the template's reference sample had this role until 2026-11-07). -It covers list/detail/create behavior, mapping, typed operation inputs, -application ports and an optimistic mutation path. +It covers list/detail/create behavior, mapping, typed operation inputs and +application ports. The feature-owned boundary and application source is these four files: -- `application/reference-feature-api.ts` -- `contracts/reference-mapper.ts` -- `adapters/reference-http-gateway.ts` -- `adapters/create-reference-feature-input.ts` +- `application/-feature-api.ts` +- `contracts/-mapper.ts` +- `adapters/-http-gateway.ts` +- `adapters/create--feature-input.ts` This document does not keep their line counts; a hand-typed count drifted -from the code (review 14-07). Measure them with -`wc -l src/features/reference-feature/{application/reference-feature-api.ts,contracts/reference-mapper.ts,adapters/reference-http-gateway.ts,adapters/create-reference-feature-input.ts}`. +from the code (review 14-07). Measure them in a generated feature with +`wc -l` on those four files. The important boundary metric is not the raw total. It is what those files need to know about the platform. diff --git a/docs/architecture/contract-ownership.md b/docs/architecture/contract-ownership.md index 270956b5..a2838c9b 100644 --- a/docs/architecture/contract-ownership.md +++ b/docs/architecture/contract-ownership.md @@ -101,8 +101,8 @@ Feature-specific contracts stay inside the vertical slice: `features//contracts` -The reference feature owns routes, schemas, mapper definitions, message -catalogs and contribution identities. Central installed files aggregate those +A feature owns its routes, schemas, mapper definitions, message catalogs and +contribution identities (`create:feature` writes them under its `contracts/`). Central installed files aggregate those contributions; they do not own their semantics. The message catalog is a deliberate special case: the compiled catalog remains diff --git a/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md b/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md index 9268cff4..92d0c560 100644 --- a/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md +++ b/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md @@ -71,9 +71,9 @@ route/form/failure 의미 값 - `check:i18n`은 catalog key와 placeholder parity, backend message JSX 렌더링을 검사한다. 검사 범위는 공통 UI 디렉터리, `src/presentation/pages`, 모든 `src/features/*/presentation`이다. 플랫폼 구성 화면 - `src/presentation/examples`와 예제 화면 - `src/features/platform-examples-feature/presentation`(1103/09-04)은 화면 - 문구 ESLint 규칙에서 일부러 뺐다(`eslint.config.ts`). + `src/presentation/examples`와 Storybook story(디자인 시스템·화면 상태 갤러리, + 2026-11-07 전에는 예제 화면 기능)는 화면 문구 ESLint 규칙에서 일부러 + 뺐다(`eslint.config.ts`). - 화면 문구가 catalog에서 오는지는 ESLint `no-restricted-syntax`가 본다 (`eslint.config.ts`의 `screenTextSelectors`, 0929/08-02). 대상은 글자가 든 `JSXText`와 표시·접근성 속성(`aria-label`, `title`, `placeholder`, `alt`, diff --git a/docs/architecture/frontend-application-foundation.md b/docs/architecture/frontend-application-foundation.md index b1fae3da..296e497e 100644 --- a/docs/architecture/frontend-application-foundation.md +++ b/docs/architecture/frontend-application-foundation.md @@ -5,8 +5,8 @@ an independent general-purpose SDK. Its architectural role is: > Frontend Application Foundation = Starter / Composition Skeleton + Reusable Capability Platform -The starter side owns bootstrap, routing, providers, project conventions and a -removable reference feature. The capability side owns reusable technical +The starter side owns bootstrap, routing, providers, project conventions and +the `create:feature` command that writes a feature; it ships no sample feature. The capability side owns reusable technical problems such as HTTP execution, Server State, authentication boundaries, IndexedDB/OPFS, Cache Storage, realtime, browser RPC, transfer and diagnostics. @@ -78,9 +78,9 @@ A reusable capability boundary is composed from: - feature-selected policy, - one capability-specific runtime. -The HTTP reference path is the first concrete example. +The HTTP path is the first concrete example. `src/adapters/http/feature-http-binding.ts` owns transport/outcome -normalization. The reference feature contributes only: +normalization. A feature `create:feature` writes contributes only: - operation ID, - route ID, @@ -152,11 +152,11 @@ repository or move dataset/migration/lifecycle policy into the feature. The repository now has two executable contribution shapes: -- Reference feature: `needs: ["http"]` -- Local Draft feature: `needs: ["indexedDb"]` +- A feature `create:feature` writes: `needs: ["http", "telemetry"]` +- The Local Draft consumer: `needs: ["indexedDb"]` -Local Draft is a compiled architecture consumer used to prove the second -capability shape; it is not added to the default product manifest. Its +Local Draft is a test fixture (`tests/fixtures/indexeddb-consumer`) used to +prove the second capability shape; it is not a feature of the product. Its browser-capability test composes the feature over the real `createIndexedDbRuntime` and native IndexedDB, proving that this seam is not limited to an in-memory contract fixture. diff --git a/docs/architecture/frontend-ports-adapters-and-boundaries.md b/docs/architecture/frontend-ports-adapters-and-boundaries.md index 0b64fe76..e633119f 100644 --- a/docs/architecture/frontend-ports-adapters-and-boundaries.md +++ b/docs/architecture/frontend-ports-adapters-and-boundaries.md @@ -124,7 +124,7 @@ bootstrap은 page별 orchestration이나 업무 규칙을 소유하지 않는다 | `src/adapters` | HTTP, auth, storage, cache, telemetry 구현 | outbound adapter | | `src/bootstrap` | runtime config와 구현 조립 | 유일한 composition root | | `src/contracts` | 여러 계층의 registry가 혼재 | 소유 계층으로 분산 | -| `src/features/reference-feature` | 완전한 제거 가능 수직 예제 | installed contribution과 제거 gate 유지 | +| `src/features/` | 제품 기능의 수직 slice. 템플릿은 비어 있고 `create:feature`가 만든다(참조 샘플은 2026-11-07 삭제) | installed contribution과 제거 gate 유지 | 현재 구조가 잘 제공하는 기반은 다음과 같다. @@ -178,7 +178,7 @@ Data Router tree, codec, surface, title, navigation, chunk/release recovery의 단일 조립 입력이며 registry/type/build 검증이 누락과 orphan을 거절한다. RP-05에서 두 번째 불일치도 닫혔다. feature별 domain/application/adapter/ -contract/presentation은 `src/features/reference-feature`가 소유하고, generic +contract/presentation은 그 기능 폴더(`src/features/`)가 소유하고, generic installed catalog만 bootstrap과 router에 노출된다. 제거 gate는 feature와 test를 삭제한 복제본에서 전체 P0 경로를 다시 실행한다. @@ -351,7 +351,7 @@ src/ platform/ features/ - reference-feature/ + / domain/ application/ ports/ @@ -376,8 +376,8 @@ src/ application capability만 둔다. `shared`, `common`, `utils` 같은 이름으로 기술과 업무 규칙을 무제한 혼합하지 않는다. -`features/reference-feature`는 구조를 설명하기 위한 완전한 수직 -슬라이스다. 이 폴더를 삭제하고 route 등록 한 곳만 제거했을 때 +`features/`는 구조를 설명하기 위한 완전한 수직 +슬라이스다(2026-11-07부터 템플릿의 예는 `create:feature`가 만드는 기능이다). 이 폴더를 삭제하고 route 등록 한 곳만 제거했을 때 typecheck, architecture check, test와 build가 모두 통과해야 한다. ## 8. Input port 설계 규칙 @@ -835,6 +835,10 @@ status/attempt/duration bucket만 전달한다. ## 16. Feature 경계와 removable reference feature +> 2026-11-07: 템플릿의 참조 샘플은 지웠다. 이 절이 참조 기능에 요구한 수직 경로와 +> 제거 검증은 `create:feature`가 만드는 기능이 맡는다(`test:feature-scaffold`가 게이트와 +> 제거를, `tests/e2e/generated-feature.spec.ts`가 실제 브라우저 경로를 본다). + Reference feature는 단순 UI fixture가 아니라 다음 경로를 모두 실행해야 한다. @@ -871,7 +875,7 @@ operation을 전역 core registry 안에 하드코딩하지 않는다. 제거 테스트는 다음을 수행해야 한다. -1. `src/features/reference-feature` 전체 삭제 +1. `src/features/` 전체 삭제 2. reference route registration 삭제 3. reference test 삭제 또는 제외 4. 잔여 import와 registry owner 검색 diff --git a/docs/architecture/starter-experience.md b/docs/architecture/starter-experience.md index 5ca50132..ef39a92c 100644 --- a/docs/architecture/starter-experience.md +++ b/docs/architecture/starter-experience.md @@ -101,21 +101,16 @@ rather than adding another independent route or data-loading convention. feature takes it over by declaring that route id (see "Product home and layouts"). Its starter links are the first three screens of the navigation. -The example screens `/examples/ui`, `/examples/states` and `/examples/auth` -are one feature, `src/features/platform-examples-feature/`, in its own context -`src/contexts/platform-examples-context/` (1103/09-04). A product turns them -off like any feature: leave the id out of `VITE_PRODUCT_FEATURES`, or delete -the feature. To delete it, remove those two folders and -`tests/features/platform-examples-feature/` (its component tests), then run -`corepack pnpm generate:feature-index`; -`corepack pnpm test:sample-removal -- --feature=platform-examples-feature` -does the same in a copy of the repository and runs the gates there. Their -routes then leave the registry, the navigation, the bundle and the manual -accessibility list (FE-GATE-028). This document keeps naming the three -folders after they are gone: `verify:documentation` checks the paths of a -removable template feature (`scripts/lib/removable-template-features.ts`) -while the feature is installed and accepts them once its `feature-module.ts` -is gone (1105/14-01). +The template ships no example feature. Its example screens (`/examples/ui`, +`/examples/states`, `/examples/auth`) and its reference sample were deleted on +2026-11-07: the design-system and screen-state galleries are workshop stories +(`src/presentation/design-system/galleries.stories.tsx`), and the manual +(`docs/manual/`) with `create:feature` shows how a feature is built. A sample a +product keeps for a while is listed in +`scripts/lib/removable-template-features.ts`: `verify:documentation` checks its +paths while it is installed and accepts them once its `feature-module.ts` is +gone (1105/14-01), and `corepack pnpm test:sample-removal` removes it in a copy +of the repository and runs the gates there. The platform overview (`/examples/platform`, `src/presentation/examples/platform-overview-page.tsx`) stays a platform @@ -125,11 +120,12 @@ routes module before the page, a second request round the 200 ms budget does not fit. Its tests are the `tests/component/starter-*.test.tsx` files. The platform's component tests (router, boundaries, shell, runtime tree) run -on the pages of the test-only feature in `tests/helpers/fixture-feature.tsx` -and keep passing without the examples. The browser-level checks in -`tests/e2e` and `tests/visual` use the example screens as their pages and run -where the examples are installed: a product that leaves them out points those -specs at its own screens or deletes them. +on the pages of the test-only feature in `tests/helpers/fixture-feature.tsx`. +The browser-level checks in `tests/e2e` and `tests/visual` use the home page, +the platform overview and the gallery stories; what needs a feature +(`tests/e2e/generated-feature.spec.ts`, the chunk recovery spec) builds a copy +of the repository with the one `create:feature` writes +(`scripts/lib/generated-feature.ts`). ### Ownership declarations @@ -168,7 +164,7 @@ selected app. Every build and check script runs it first; run it yourself with invalidation, topic versions and the external `contractPackages` the release manifest is checked against at boot), its message catalogs, and `loadRuntime`, which imports `feature-runtime.ts` dynamically. - `src/features/reference-feature/feature-module.ts` is the complete example. + `create:feature` writes a complete one. 2. Create `src/features//feature-runtime.ts` with `defineFeatureRuntime`: the `schemas` (FE-REG-SCHEMA rows for the feature's route and API schemas), the adapter contributions @@ -183,13 +179,14 @@ selected app. Every build and check script runs it first; run it yourself with executes, and `check:registries` governs the FE-REG-API row projected from it (`projectApiOperationRows` in `src/contracts/api-operations.ts`). A product feature's contract contribution uses an `EXTERNAL_PACKAGE` - source. `TEMPLATE_FIXTURE` belongs to `reference-feature` only and never - joins the release contract set; the composer rejects it anywhere else. + source. `TEMPLATE_FIXTURE` was the template's reference sample source; it + never joins the release contract set, and the composer rejects it in any + product feature. 3. Create `src/features//context-routes.ts` exporting `FEATURE_CONTEXT_ROUTES`. Page components are imported lazily here, and each route handle carries the route's params/search `codecs`; the owning context loads this file only when its route root is visited - (`src/features/reference-feature/context-routes.ts`). Each handle's + (a `create:feature --with-create` feature's `context-routes.ts`). Each handle's `routeId` must be a route of a feature contract in the same context; the context refuses the routes when they load, naming the route, context and features (`src/contexts/bounded-context-module.ts`). diff --git a/docs/architecture/typescript-state-and-data-flow.md b/docs/architecture/typescript-state-and-data-flow.md index a3ff6b2d..e845534d 100644 --- a/docs/architecture/typescript-state-and-data-flow.md +++ b/docs/architecture/typescript-state-and-data-flow.md @@ -157,7 +157,7 @@ export interface ApplicationFeatureInputs {} declare module "../../../application/ports/in/application-api.ts" { interface ApplicationFeatureInputs { - "reference-feature": ReferenceFeatureInput; + "invoice-feature": InvoiceFeatureInput; } } ``` @@ -342,8 +342,8 @@ export function useCreateResourceMutation() { `useApplicationMutation`은 bound 정의(`BoundMutation`)만 받는다(1101/08-03). `{ execute }`만 넘기는 raw 형태는 멱등 키와 scope 확인 없이 쓰기를 보내고 결과 불명 뒤 "다시 보내기"가 아무것도 하지 않아 타입에서 막는다. 실제 정의는 -`src/features/reference-feature/presentation/use-reference-feature.ts`의 -`REFERENCE_CREATE_MUTATION_POLICY`를 본다. +`create:feature --with-create`가 만드는 `presentation/use--create.ts`의 +작성 뮤테이션 정책을 본다. 기본 mutation은 navigation만으로 취소됐다고 가정하지 않는다. 서버 작업의 취소가 안전한 operation만 controller가 보관한 `AbortController`와 명시적 cancel action을 @@ -622,10 +622,9 @@ Form 또는 TanStack Form adapter를 평가한다. - controller와 mapping: `src/presentation/forms` - layout-only template: `src/presentation/templates` -- feature form schema/command mapper: - `src/features/reference-feature/presentation/reference-resource-form.ts` -- 실제 create page: - `src/features/reference-feature/presentation/reference-resource-form-page.tsx` +- feature form schema/command mapper: `create:feature --with-create`의 + `presentation/-form.ts` +- 실제 create page: 같은 판의 `presentation/-create-page.tsx` `ApiFailure.validationIssues`는 HTTP 경계가 투영한 `path`와 `code`만 담는다. backend message와 알 수 없는 path는 field copy로 사용하지 않는다. diff --git a/docs/contracts/compatibility.md b/docs/contracts/compatibility.md index 9185fd3b..9c481ac7 100644 --- a/docs/contracts/compatibility.md +++ b/docs/contracts/compatibility.md @@ -25,7 +25,7 @@ reader that accepts it must ship before any writer sends it. | `FEATURE_OVERRIDES` | record; unknown feature id ignored | additive | `featureOverrideArtifactSchema` in `src/contracts/release-artifacts.ts` | | Release manifest V2 | strict object | breaking | `releaseManifestV2ArtifactSchema` in `src/contracts/release-artifacts.ts` | | HTTP success/failure envelope (V3 with `responseEnvelope: "ENVELOPE_V1"`) | strict object (`meta` strips) | breaking | `successEnvelopeSchema`, `failureEnvelopeSchema` in `src/adapters/http/backend-envelope.ts` | -| HTTP V3 response DTO (reference feature) | `.strip()` drops unknown fields | additive | `referenceResourceDtoSchema` in `src/features/reference-feature/contracts/reference-schemas.ts` | +| HTTP V3 response DTO (a feature's) | `.strip()` drops unknown fields | additive | `ItemDtoSchema` in `contracts/-schemas.ts` of a feature `create:feature` writes | | Realtime envelope | exact key set; unknown `eventType` is `MALFORMED_EVENT` | breaking | `decodeUnsafe` in `src/adapters/realtime/event-codec.ts` | | Browser RPC transport error code | closed vocabulary; unknown code is a protocol violation | breaking | `decodeTransportFailure` in `src/adapters/browser-rpc/browser-rpc-runtime.ts` | | Persisted client storage | versioned key; incompatible value discarded | use a new key version | `defineStorageKey` in `src/contracts/storage-keys.ts` | diff --git a/docs/manual/reference/create-feature.md b/docs/manual/reference/create-feature.md index 0d08b926..f515d8f7 100644 --- a/docs/manual/reference/create-feature.md +++ b/docs/manual/reference/create-feature.md @@ -156,10 +156,13 @@ node scripts/write-dev-release-manifest.ts # dev manifest에서 그 기능의 - `test:feature-scaffold` (FE-GATE-020) - 저장소 복사본에 기능 둘(기본 하나, `--with-create --keyed` 하나)을 만들고 커밋한 뒤 게이트를 돈다. - 타입, lint, 아키텍처, 레지스트리, i18n, 디자인 시스템, 진단, 문서, unit, component, integration, 기능 테스트, 커버리지, CI 계약, 빌드. -- `test:sample-removal` (FE-GATE-020) - - 참조 기능을 지운 복사본에서 이 명령(`--with-create`)으로 기능을 만들고 같은 게이트를 다시 돈다. 명령과 쓰기 slice가 참조 기능에 기대지 않는다는 증거다. +- `test:sample-removal -- --feature=` (`test:feature-scaffold`가 부른다) + - 위에서 만든 기본 기능을 복사본에서 지우고 같은 게이트를 다시 돈다. 생성 기능이 지워진다는 증거다. + - 인자 없이 돌면(FE-GATE-020) `scripts/lib/removable-template-features.ts`에 적힌 샘플을 하나씩 지우고, 지운 복사본에서 이 명령(`--with-create`)으로 기능을 만들어 게이트를 다시 돈다. 템플릿은 그 목록이 비어 있어 건너뛰었다고(SKIP) 출력한다. +- `tests/e2e/generated-feature.spec.ts` (`test:e2e`, FE-GATE-008) + - 저장소 복사본에 `--with-create --keyed` 기능을 만들어 빌드하고, 실제 브라우저에서 로그인 뒤 목록, 폼 검증, 이탈 확인, 저장(멱등 키), 429 뒤 다시 시도, 결과 불명과 같은 키 재전송, 접근성(axe)을 본다. 생성기 출력이 바뀌면 여기서 잡힌다. ## 알려진 한계 -- 드릴은 브라우저 테스트(FE-GATE-008·009의 `test:e2e`, `test:a11y` 등)와 `test:system`을 돌리지 않는다. `check:bundle`(FE-GATE-012)은 돈다. +- 드릴은 브라우저 테스트(FE-GATE-008·009의 `test:e2e`, `test:a11y` 등)와 `test:system`을 돌리지 않는다. `check:bundle`(FE-GATE-012)은 돈다. 브라우저에서의 동작은 위 e2e spec이 고정한 이름(`order-feature`)의 기능 하나로만 본다. - 새 context는 앱이 하나일 때만 만든다. 앱이 여럿이면 `--context`로 기존 context를 고른다. diff --git a/docs/operations/adapter-remediation-ledger.md b/docs/operations/adapter-remediation-ledger.md index 5e48aab7..4c8016c6 100644 --- a/docs/operations/adapter-remediation-ledger.md +++ b/docs/operations/adapter-remediation-ledger.md @@ -194,7 +194,7 @@ Captured after every correctness task landed. | `git diff --check` | 0 | clean | | `corepack pnpm test:component` | 0 | 126 passed | | `corepack pnpm test:integration` | 0 | 52 passed | -| `corepack pnpm test:reference-feature` | 0 | 26 passed | +| 참조 샘플 기능 시험(그 script는 2026-11-07 샘플과 함께 지웠다) | 0 | 26 passed | | `corepack pnpm test:recipes` | 0 | 17 passed | | `corepack pnpm test:unit` | 1 | 1585 passed / 19 failed tests; the 19 are the unchanged pre-existing `ci-artifact-contract` sandbox failures | | `corepack pnpm check:registries` | 0 | 11 registries PASS | @@ -340,7 +340,7 @@ Run on the landed tree. Only what actually passed is claimed as passing. | `tests/unit` + `tests/integration`, no exclusions | — | 1643 passed / 1747; the 104 failures are the four environmental files below | | `corepack pnpm test:component` | 0 | 126 passed | | `corepack pnpm test:recipes` | 0 | 17 passed | -| `corepack pnpm test:reference-feature` | 0 | 26 passed | +| 참조 샘플 기능 시험(그 script는 2026-11-07 샘플과 함께 지웠다) | 0 | 26 passed | ### Environmental failures, not claimed as green diff --git a/docs/operations/performance-evidence.md b/docs/operations/performance-evidence.md index c1c6b1de..820861f3 100644 --- a/docs/operations/performance-evidence.md +++ b/docs/operations/performance-evidence.md @@ -20,15 +20,16 @@ Performance evidence is deliberately split by measurement context: 보고 예산을 정한다. 기준선 숫자는 이 문서에 적지 않는다. 손으로 적은 숫자는 두 번 낡았다. 기록은 -`config/scale/feature-shape-ceilings.json`의 `initialJavascript` 한 곳이다. 이 파일과 아래 -측정 테스트는 참조 기능을 복사해 재므로 샘플과 함께 지워진다. 문서 검사는 샘플을 지운 사본에서 -이 경로들을 요구하지 않는다(`scripts/lib/removable-template-features.ts`). +`config/scale/feature-shape-ceilings.json`의 `initialJavascript` 한 곳이다. 측정은 +`create:feature --with-create --keyed`가 만드는 기능을 복사해 잰다 +(`scripts/scale/measure-feature-shape-growth.ts`, 2026-11-07 전에는 참조 샘플을 복사했다). | 칸 | 뜻 | |---|---| | `gzipBytes`, `files` | 템플릿 그대로의 초기 JS gzip bytes와 파일 수(entry 포함) | -| `perFeatureGzipBytes` | 있는 context에 참조 기능 모양 기능을 하나 더할 때 느는 초기 JS. 상한 1 KiB | -| `perContextGzipBytes` | 새 context를 하나 더할 때 느는 초기 JS. 상한 512 B | +| `firstFeatureGzipBytes` | 기능이 없는 템플릿에 첫 기능(과 그 context)을 더할 때 느는 초기 JS. 모든 기능이 함께 쓰는 코드가 이때 초기 청크에 들어온다. 한 번만 든다. 상한 없음(전체는 `check:bundle`의 예산이 막는다) | +| `perFeatureGzipBytes` | 있는 context에 생성 기능 모양 기능을 하나 더할 때 느는 초기 JS. 상한 1 KiB | +| `perContextGzipBytes` | 둘째 기능을 같은 context 대신 새 context에 둘 때 느는 초기 JS. 상한 512 B | - `tests/unit/feature-shape-growth.test.ts`(unit, merge 단계)가 매번 빌드해 이 값을 재고, 상한을 넘거나 기록과 다르면(합계 256 B 초과, 파일 수 불일치, 기능· @@ -120,11 +121,14 @@ lab 측정(`scripts/test-performance.ts`, FE-GATE-026)은 local 프로필 build `context.sampling.targetDeepLink`에 남긴다. 예산은 `cls`와 같다(1105/15-01). - 대상 화면(플랫폼 구성)은 기능 코드를 받지 않으므로 기능이 늘어도 수치가 거의 그대로다. 그래서 run마다 설치된 기능이 가진 첫 공개 내비게이션 - 라우트(`labFeatureRoute`, 템플릿에서는 `EXAMPLES_UI`)를 같은 시계로 따로 잰다 + 라우트(`labFeatureRoute`)를 같은 시계로 따로 잰다 (`metrics.featureRouteInteractionMs`, `context.sampling.featureRoute`, 1105/15-04). 그런 라우트가 없으면 `measured: false`로 남기고 판정하지 않는다. + 템플릿은 기능이 없어 재지 않는다(2026-11-07 예제 화면 삭제 뒤. 그 전에는 예제 + 화면 `/examples/ui`가 이 라우트였다). 공개 내비게이션 라우트를 가진 제품 기능이 + 생기면 그 라우트를 잰다. - 예산 `lab.featureRouteInteractionMs`는 500 ms다. 근거: `8a44226`에서 lab - 조건으로 `EXAMPLES_UI`를 5회 재니 중앙값 406 ms(403~410)였다. 그 진입은 요청 + 조건으로 그때의 예제 화면 라우트를 5회 재니 중앙값 406 ms(403~410)였다. 그 진입은 요청 두 묶음이다(context 라우트 모듈과 기능 실행부, 그다음 페이지 청크와 공유 청크). 둘째 묶음이 약 100 ms(클릭 뒤 98~204 ms)다. 500 ms는 지금 진입을 통과시키고, 같은 크기의 묶음이 하나 더 붙으면 넘는다. diff --git a/docs/styling/design-tokens.md b/docs/styling/design-tokens.md index bd31f947..dae8bd8e 100644 --- a/docs/styling/design-tokens.md +++ b/docs/styling/design-tokens.md @@ -62,8 +62,8 @@ Arbitrary-value policy: - user-controlled or runtime-composed class strings are forbidden - class variants must be selected from a closed static map -The removable reference feature may demonstrate tokens, but generic production -starter modules do not import its domain, application, adapter, or presentation +A feature may demonstrate tokens, but generic production starter modules do +not import a feature's domain, application, adapter, or presentation implementation. This file documents the currently implemented token and primitive baseline. diff --git a/docs/testing/frontend-platform-testing-strategy.md b/docs/testing/frontend-platform-testing-strategy.md index 5cdd8456..2bf3fb19 100644 --- a/docs/testing/frontend-platform-testing-strategy.md +++ b/docs/testing/frontend-platform-testing-strategy.md @@ -503,8 +503,9 @@ tests/support/query/ helper는 production default를 복사하지 않는다. production factory를 호출하고 필요한 시간·retry만 test override로 주입한다. -RP-05의 executable reference matrix는 -`tests/features/reference-feature`에 모여 있다. 설치 모드에서는 URL codec과 +RP-05의 executable reference matrix는 참조 샘플의 시험 폴더에 모여 있었다(2026-11-07 +샘플과 함께 삭제). 지금 기능 하나의 경로는 `create:feature`가 만든 기능의 시험 +(`tests/features//`)과 `tests/e2e/generated-feature.spec.ts`가 본다. 그때 설치 모드에서는 URL codec과 query key/HTTP search의 동일성, DTO 차단, loading/success/empty/terminal, refreshing/stale, pending/duplicate/optimistic/conflict/rollback과 MSW production composition을 검증한다. 제거 모드는 feature source/tests와 installed @@ -513,8 +514,8 @@ contract/runtime/adapter contribution을 제거한 복제본에서 P0 gate와 bu RP-06 form/page matrix는 `tests/component/form-foundation.test.tsx`, `tests/component/page-templates.test.tsx`, -`tests/features/reference-feature/reference-page.test.tsx`와 -`tests/e2e/reference-form.spec.ts`에 있다. client validation에서 command 0회와 +생성 기능의 `-create-page.test.tsx`와 +`tests/e2e/generated-feature.spec.ts`에 있다(2026-11-07 전에는 참조 샘플의 페이지 시험과 폼 e2e). client validation에서 command 0회와 첫 오류 focus, Zod transform/default, pending 중 중복 제출, 승인된 422 field/unknown field mapping, conflict 입력 보존, reset/dirty, navigation confirmation/focus restore, URL/storage 비노출과 320px reflow를 검증한다. diff --git a/docs/testing/taxonomy.md b/docs/testing/taxonomy.md index f54b4aad..d44b88f2 100644 --- a/docs/testing/taxonomy.md +++ b/docs/testing/taxonomy.md @@ -19,7 +19,7 @@ Each gate is blocking in its declared scope. Failures are not downgraded with `test:all` is the normal product-development loop. It runs, in order, `test:runtime-schema`, `test:unit`, `test:contract`, `test:component`, `test:integration`, the rest of what `test:coverage` runs (`tests/features`, -the reference sample's tests among them, `tests/scripts` and +each installed feature's tests, `tests/scripts` and `tests/scale/browser-soak.contract.test.ts`), `test:platform` (`tests/platform` and `tests/architecture`), `check:release-coherence` and `test:recipes` (`package.json` `test:all`). So every Vitest path the merge gate's coverage diff --git a/eslint.config.ts b/eslint.config.ts index cc8f0336..fbdcd82a 100644 --- a/eslint.config.ts +++ b/eslint.config.ts @@ -458,9 +458,9 @@ const hookRules = { // template literal, a ternary, an object prop such as `heading.title`) is not // seen; review catches those. A product replaces these selectors in its own // config, for example to allow a brand name or to drop the rule for a -// one-locale product. The platform overview (src/presentation/examples), -// the example screens (src/features/platform-examples-feature/presentation) -// and stories are workshop code and stay out; tests are outside these folders. +// one-locale product. The platform overview (src/presentation/examples) and +// stories (the galleries among them) are workshop code and stay out; tests +// are outside these folders. const screenTextDirectories = [ "src/presentation/boundaries", "src/presentation/components", @@ -912,13 +912,9 @@ export default [ `${directory}/**/*.tsx`, `tests/fixtures/i18n/*/${directory}/**/*.tsx`, ]), - // 1103/09-04. The example screens moved from src/presentation/examples - // into this feature and stay workshop code: their copy is Korean in every + // Stories are workshop code: the galleries' copy is Korean in every // locale on purpose (08-07). - ignores: [ - "**/*.stories.tsx", - "src/features/platform-examples-feature/presentation/**", - ], + ignores: ["**/*.stories.tsx"], rules: { "no-restricted-syntax": [ ...commonSecurityRules["no-restricted-syntax"], diff --git a/package.json b/package.json index 4d3c87c7..d3d1440d 100644 --- a/package.json +++ b/package.json @@ -78,7 +78,6 @@ "test:optional-recipe-removal": "node scripts/test-optional-recipe-removal.ts", "test:browser-file-storage-removal": "node scripts/test-browser-file-storage-runtime-removal.ts", "test:realtime-removal": "node scripts/test-realtime-runtime-removal.ts", - "test:reference-feature": "node scripts/run-vitest.ts run tests/features/reference-feature --reporter=default --reporter=junit --outputFile.junit=artifacts/tests/reference-feature.xml --passWithNoTests", "check:v8-coverage-counter-semantics": "node scripts/check-v8-coverage-counter-semantics.ts", "test:coverage": "corepack pnpm check:v8-coverage-counter-semantics && node scripts/run-vitest.ts run tests/runtime-schema tests/unit tests/contract tests/component tests/integration tests/features tests/platform tests/architecture tests/release tests/scripts tests/scale/browser-soak.contract.test.ts --coverage --maxWorkers=4 --reporter=default --reporter=junit --outputFile.junit=artifacts/tests/coverage.xml && node scripts/check-risk-coverage.ts", "check:coverage:fixture": "node scripts/check-risk-coverage.ts --summary tests/fixtures/coverage/below-threshold.json --artifact artifacts/quality/risk-coverage-fixture.json", @@ -149,7 +148,7 @@ "check:request-fanout": "node scripts/check-request-fanout.ts && node scripts/check-request-fanout.ts --fixture", "check:app-build-input": "node scripts/check-app-build-input.ts", "check:app-build-input:bundle": "node scripts/check-app-build-input.ts --require-bundle", - "test:extreme-scale:focused": "node scripts/run-vitest.ts run tests/scale/global-local-independence.test.ts tests/architecture/app-build-input.test.ts tests/architecture/request-fanout.test.ts tests/platform/traffic/request-fanout.test.ts tests/platform/traffic/request-deduplication.test.ts tests/features/reference-feature/reference-request-fanout.test.ts tests/features/reference-feature/reference-request-deduplication.test.ts tests/scripts/generate-product-feature-index.test.ts --reporter=default", + "test:extreme-scale:focused": "node scripts/run-vitest.ts run tests/scale/global-local-independence.test.ts tests/architecture/app-build-input.test.ts tests/architecture/request-fanout.test.ts tests/platform/traffic/request-fanout.test.ts tests/platform/traffic/request-deduplication.test.ts tests/scripts/generate-product-feature-index.test.ts --reporter=default", "check:release-coherence": "node scripts/run-vitest.ts run tests/platform/release tests/release --reporter=default" }, "dependencies": { diff --git a/public/config.json b/public/config.json index e8466b6e..2ad5dfc4 100644 --- a/public/config.json +++ b/public/config.json @@ -15,7 +15,5 @@ "SERVICE_WORKER": "DEFAULT", "OFFLINE_COMMANDS": "DEFAULT" }, - "FEATURE_OVERRIDES": { - "reference-feature": "DEFAULT" - } + "FEATURE_OVERRIDES": {} } diff --git a/public/release-manifest.json b/public/release-manifest.json index 471e2dd2..ed7bd068 100644 --- a/public/release-manifest.json +++ b/public/release-manifest.json @@ -10,13 +10,6 @@ "routeChunks": { "route-home": "src/presentation/pages/home-page.tsx", "route-examples-platform": "src/presentation/examples/platform-overview-page.tsx", - "route-examples-ui": "src/features/platform-examples-feature/presentation/ui-gallery-page.tsx", - "route-examples-states": "src/features/platform-examples-feature/presentation/state-gallery-page.tsx", - "route-examples-auth": "src/features/platform-examples-feature/presentation/auth-example-page.tsx", - "route-reference-resources": "src/features/reference-feature/presentation/reference-resource-page.tsx", - "route-reference-resource-detail": "src/features/reference-feature/presentation/reference-resource-detail-page.tsx", - "route-reference-resource-form": "src/features/reference-feature/presentation/reference-resource-form-page.tsx", - "route-reference-resource-status": "src/features/reference-feature/presentation/reference-resource-status-page.tsx", "route-not-found": "src/presentation/pages/not-found-page.tsx" }, "contractSet": { diff --git a/scripts/check-browser-file-storage-boundaries.ts b/scripts/check-browser-file-storage-boundaries.ts index 9866e541..1d23ab2f 100644 --- a/scripts/check-browser-file-storage-boundaries.ts +++ b/scripts/check-browser-file-storage-boundaries.ts @@ -141,10 +141,10 @@ const misplacedAdapterResults = [ ), }, { - file: "src/features/reference-feature/adapters/boundary-fixture.ts", + file: "src/features/fixture-feature/adapters/boundary-fixture.ts", result: runEslintSource( objectUrlBypassSource, - "src/features/reference-feature/adapters/boundary-fixture.ts", + "src/features/fixture-feature/adapters/boundary-fixture.ts", ), }, { diff --git a/scripts/check-i18n.ts b/scripts/check-i18n.ts index 0c2c04c7..ab236d6b 100644 --- a/scripts/check-i18n.ts +++ b/scripts/check-i18n.ts @@ -59,9 +59,8 @@ if (!fixtureMode) { // from an ordinary `.message` read. Fixture mode runs the ESLint rule on the // fixture trees too, so this one gate shows the whole i18n contract rejecting // every forbidden file and passing the allowed one. -// `src/presentation/examples` (the platform overview) and the example -// screens (`src/features/platform-examples-feature/presentation`, 1103/09-04) -// are workshop code and stay out of the ESLint rule's scope on purpose. +// `src/presentation/examples` (the platform overview) and the stories are +// workshop code and stay out of the ESLint rule's scope on purpose. const forbiddenFixtureRoot = "tests/fixtures/i18n/forbidden"; const allowedFixtureRoot = "tests/fixtures/i18n/allowed"; const sourceRoot = fixtureMode ? forbiddenFixtureRoot : "."; diff --git a/scripts/lib/a11y-data-state.ts b/scripts/lib/a11y-data-state.ts index 07db68ab..e5aee77c 100644 --- a/scripts/lib/a11y-data-state.ts +++ b/scripts/lib/a11y-data-state.ts @@ -113,7 +113,7 @@ type ReadFacts = Readonly<{ * not listed. * * This finds the detail pages that take their params schema from their read - * (the reference sample and every `create:feature --with-create` slice). A + * (every `create:feature --with-create` slice). A * detail page whose params schema differs is not found, and its record alone * decides, as before. */ diff --git a/scripts/lib/feature-residue.ts b/scripts/lib/feature-residue.ts index 459a6262..95202ea2 100644 --- a/scripts/lib/feature-residue.ts +++ b/scripts/lib/feature-residue.ts @@ -34,8 +34,8 @@ import path from "node:path"; * a test title), and no text rule tells that from a reference, so a spec * that names only a one-word ID is not found either. * - * The reference sample keeps its own, wider pattern in - * scripts/test-sample-removal.ts: the template owns all of its files. + * The drill applies the same rule to a sample a project lists in + * scripts/lib/removable-template-features.ts. */ function escapeRegExp(value: string): string { return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&"); diff --git a/tests/e2e/support/generated-feature.ts b/scripts/lib/generated-feature.ts similarity index 57% rename from tests/e2e/support/generated-feature.ts rename to scripts/lib/generated-feature.ts index 3e2a3f0f..8430f836 100644 --- a/tests/e2e/support/generated-feature.ts +++ b/scripts/lib/generated-feature.ts @@ -1,14 +1,24 @@ import { spawnSync } from "node:child_process"; +import { cp, mkdtemp, rename, rm } from "node:fs/promises"; +import { existsSync } from "node:fs"; +import { tmpdir } from "node:os"; import path from "node:path"; import { pathToFileURL } from "node:url"; +import { localBuildEnvironment } from "./build-environment.ts"; +import { linkFixtureNodeModules } from "./fixture-node-modules.ts"; +import { REMOVAL_FIXTURE_COPY_TARGETS } from "./removal-fixture.ts"; + /** - * 2026-11-07. The template ships no feature. The browser checks that one - * feature works end to end (its route, form and save, a save whose result is - * lost) run on the feature `create:feature` writes: a fixture build - * (fixture-builds.ts) gets it with `addGeneratedFeature` as its edit, so a - * change of the generator's output fails here. The `--keyed` write slice is - * the widest one the command makes. + * 2026-11-07. The template ships no feature. What needs one in a real build + * runs on the feature `create:feature` writes, added to a copy of the + * repository: the browser checks that one feature works end to end (route, + * form, save, a save whose result is lost; tests/e2e/generated-feature.spec.ts + * and the chunk recovery spec, whose fixture builds take `addGeneratedFeature` + * as their edit) and the browser soak's failing-backend visits + * (scripts/scale/browser-soak.ts, `buildWithGeneratedFeature`). A change of + * the generator's output fails there. The `--keyed` write slice is the widest + * one the command makes. */ export const GENERATED_FEATURE_ID = "order-feature"; @@ -78,3 +88,39 @@ export function generatedFeature(root: string): GeneratedFeature { export function routePath(route: GeneratedRoute, id?: string): string { return id === undefined ? route.path : route.path.replace(/:[A-Za-z][A-Za-z0-9_]*/u, id); } + +/** + * A production build of a copy of the repository with the generated feature, + * in the local configuration. `remove` deletes the copy. + */ +export async function buildWithGeneratedFeature(prefix: string): Promise< + Readonly<{ dist: string; feature: GeneratedFeature; remove(): Promise }> +> { + const root = await mkdtemp(path.join(tmpdir(), `${prefix}-`)); + const remove = () => rm(root, { recursive: true, force: true }); + try { + for (const entry of REMOVAL_FIXTURE_COPY_TARGETS) { + if (!existsSync(entry)) continue; + await cp(entry, path.join(root, entry), { + recursive: true, + filter: (source) => !source.includes(`${path.sep}.generated`), + }); + } + await linkFixtureNodeModules(root); + await addGeneratedFeature(root); + const build = spawnSync(process.execPath, ["scripts/build-frontend.ts"], { + cwd: root, + encoding: "utf8", + env: localBuildEnvironment(), + }); + if (build.status !== 0) { + throw new Error(`scripts/build-frontend.ts failed in ${root}:\n${build.stdout}\n${build.stderr}`); + } + const dist = path.join(root, "dist-generated-feature"); + await rename(path.join(root, "dist"), dist); + return Object.freeze({ dist, feature: generatedFeature(root), remove }); + } catch (error) { + await remove(); + throw error; + } +} diff --git a/scripts/lib/removable-template-features.ts b/scripts/lib/removable-template-features.ts index 39e5aed2..aea13657 100644 --- a/scripts/lib/removable-template-features.ts +++ b/scripts/lib/removable-template-features.ts @@ -1,14 +1,16 @@ /** - * The features this template ships that a copied project may delete: the - * reference sample (README "Files you can delete after copying") and the - * example screens (docs/architecture/starter-experience.md, CHANGELOG "먼저 - * 할 일" 6). Each owns its folder under `src/features/` and `tests/features/` - * and the context it is the only feature of. The reference sample also owns - * files outside them, which `scripts/test-sample-removal.ts` deletes with it. + * The sample features a project ships and may delete later: each owns its + * folder under `src/features/` and `tests/features/`, the context it is the + * only feature of, and possibly files and package scripts outside them. * - * This is the one list. The removal drill reads the reference sample's paths - * and scripts from it, and the documentation check reads the whole of it: a - * feature counts as deleted once its `feature-module.ts` is gone. + * The template ships none: its reference sample and example screens were + * deleted on 2026-11-07, when the manual and `create:feature` took over their + * roles. A project that keeps a sample of its own lists it here. Then + * `test:sample-removal` without `--feature` (FE-GATE-020) deletes each one + * from a copy of the repository with these paths and scripts and runs the + * gates, and verify:documentation lets the documents name its paths until + * the sample is gone: a sample counts as deleted once its + * `feature-module.ts` is. */ export type RemovableTemplateFeature = Readonly<{ /** Its FEATURE_MODULE_ID, also its folder under src/features and tests/features. */ @@ -21,36 +23,7 @@ export type RemovableTemplateFeature = Readonly<{ scripts: readonly string[]; }>; -export const REMOVABLE_TEMPLATE_FEATURES: readonly RemovableTemplateFeature[] = Object.freeze([ - Object.freeze({ - featureId: "reference-feature", - contextDirectory: "src/contexts/reference-context", - // 0929/10-02. The HTTP scenario catalog (tests/mocks) and the negative - // type fixtures of the feature APIs run on the test contracts, so they - // are platform checks and stay (commonTestPaths in the drill). - extraPaths: Object.freeze([ - "tests/component/product-feature-switch.test.tsx", - "tests/e2e/reference-form.spec.ts", - "tests/e2e/reference-route.spec.ts", - "tests/e2e/reference-save.spec.ts", - // 11-04: the growth measurement copies this sample feature. - "tests/unit/feature-shape-growth.test.ts", - "scripts/scale/measure-feature-shape-growth.ts", - "config/scale/feature-shape-growth.json", - "config/scale/feature-shape-ceilings.json", - ]), - scripts: Object.freeze(["test:reference-feature"]), - }), - // 1103/09-04. The example screens /examples/ui, /examples/states and - // /examples/auth. The platform overview (/examples/platform) is a platform - // route and is not part of it. - Object.freeze({ - featureId: "platform-examples-feature", - contextDirectory: "src/contexts/platform-examples-context", - extraPaths: Object.freeze([]), - scripts: Object.freeze([]), - }), -]); +export const REMOVABLE_TEMPLATE_FEATURES: readonly RemovableTemplateFeature[] = Object.freeze([]); /** Every path removing `feature` deletes: its folders, its context and its extra files. */ export function removableTemplateFeaturePaths(feature: RemovableTemplateFeature): readonly string[] { diff --git a/scripts/lib/removal-fixture.ts b/scripts/lib/removal-fixture.ts index de5b83a9..f3246247 100644 --- a/scripts/lib/removal-fixture.ts +++ b/scripts/lib/removal-fixture.ts @@ -40,7 +40,7 @@ export const REMOVAL_FIXTURE_COPY_TARGETS = Object.freeze([ /** * This is the only copy-target list. Each removal script used to keep its own, - * and they drifted: the reference-feature fixture omitted + * and they drifted: the reference sample's fixture omitted * `playwright.capabilities.config.ts`, which the repository file inventory * requires, so supply-chain generation failed inside the fixture and took every * provider suite down with it — twenty-odd failures with one cause. diff --git a/scripts/scale/browser-soak.ts b/scripts/scale/browser-soak.ts index 66ef7200..0d94bb3d 100644 --- a/scripts/scale/browser-soak.ts +++ b/scripts/scale/browser-soak.ts @@ -4,6 +4,7 @@ import { createServer, type Server } from "node:http"; import type { AddressInfo } from "node:net"; import path from "node:path"; +import { buildWithGeneratedFeature } from "../lib/generated-feature.ts"; import { classifyCounterSeries, classifyMemorySlope, @@ -13,8 +14,12 @@ import { /** * scale-architecture.md §33 / §44. Browser soak on the existing Playwright runner. * - * Serves the built `dist/` on an OS-assigned 127.0.0.1 port and keeps one - * long-lived page cycling through the app's routes by client-side navigation. + * Serves a build on an OS-assigned 127.0.0.1 port and keeps one long-lived + * page cycling through the app's routes by client-side navigation. One of + * them is a feature's protected list (`featureRoute`), signed in once, whose + * reads fail. The template has no feature: by default the soak builds a copy + * with the one `create:feature` writes (scripts/lib/generated-feature.ts); + * `--dist` with `--feature-route` soaks a build of a product's own. * The served runtime config turns telemetry on (pointed at a local collector) * and points the API at a stub that always answers 503, so every cycle also * exercises bounded retries and telemetry under a sustained backend failure. @@ -51,9 +56,9 @@ export type SoakSummary = Readonly<{ storageKeyDelta: number; storageByteDelta: number; apiRequests: number; - referenceVisits: number; - settledReferenceVisits: number; - apiRequestsPerReferenceVisit: number; + featureVisits: number; + settledFeatureVisits: number; + apiRequestsPerFeatureVisit: number; telemetryPosts: number; telemetryEvents: number; maxTelemetryPostsPerMinute: number; @@ -83,7 +88,7 @@ export const SOAK_LIMITS = Object.freeze({ maxTimerDelta: 10, maxStorageKeyDelta: 2, /** One logical execution: 1 attempt + at most 2 retries. */ - maxApiRequestsPerReferenceVisit: 3, + maxApiRequestsPerFeatureVisit: 3, /** Two bounded pipelines (platform events + feature events) x 20/min. */ maxTelemetryPostsPerMinute: 40, }); @@ -104,8 +109,8 @@ export function summarizeSoak( export type SoakTotals = Readonly<{ cycles: number; navigationFailures: number; - referenceVisits: number; - settledReferenceVisits: number; + featureVisits: number; + settledFeatureVisits: number; finalInFlightRequests: number; apiRequests: number; telemetryPosts: number; @@ -148,12 +153,12 @@ export function evaluateSoak( storageKeyDelta: delta((sample) => sample.storageKeys), storageByteDelta: delta((sample) => sample.storageBytes), apiRequests: totals.apiRequests, - referenceVisits: totals.referenceVisits, - settledReferenceVisits: totals.settledReferenceVisits, - apiRequestsPerReferenceVisit: - totals.referenceVisits === 0 + featureVisits: totals.featureVisits, + settledFeatureVisits: totals.settledFeatureVisits, + apiRequestsPerFeatureVisit: + totals.featureVisits === 0 ? 0 - : Math.round((totals.apiRequests / totals.referenceVisits) * 1_000) / 1_000, + : Math.round((totals.apiRequests / totals.featureVisits) * 1_000) / 1_000, telemetryPosts: totals.telemetryPosts, telemetryEvents: totals.telemetryEvents, maxTelemetryPostsPerMinute, @@ -192,15 +197,15 @@ export function evaluateSoak( { name: "backend failure exercised", passed: - summary.settledReferenceVisits > 0 && summary.apiRequests > 0 && summary.telemetryEvents > 0, - detail: `${summary.settledReferenceVisits} settled visits, ${summary.apiRequests} API requests, ${summary.telemetryEvents} telemetry events`, + summary.settledFeatureVisits > 0 && summary.apiRequests > 0 && summary.telemetryEvents > 0, + detail: `${summary.settledFeatureVisits} settled visits, ${summary.apiRequests} API requests, ${summary.telemetryEvents} telemetry events`, }, { name: "request amplification", passed: - summary.referenceVisits > 0 && - summary.apiRequestsPerReferenceVisit <= SOAK_LIMITS.maxApiRequestsPerReferenceVisit, - detail: `${summary.apiRequests} requests / ${summary.referenceVisits} visits`, + summary.featureVisits > 0 && + summary.apiRequestsPerFeatureVisit <= SOAK_LIMITS.maxApiRequestsPerFeatureVisit, + detail: `${summary.apiRequests} requests / ${summary.featureVisits} visits`, }, { name: "telemetry rate", @@ -348,6 +353,8 @@ export async function runBrowserSoak( intervalMs: number; warmupMs: number; routes: readonly string[]; + /** A feature's protected list: signed in on, then visited with the rest. */ + featureRoute: string; }>, ): Promise { try { @@ -397,13 +404,14 @@ export async function runBrowserSoak( await page.addInitScript(PAGE_PROBES); const cdp = await page.context().newCDPSession(page); await cdp.send("Performance.enable"); - await page.goto(`${baseUrl}/examples/reference-resources`, { waitUntil: "load" }); + await page.goto(`${baseUrl}${options.featureRoute}`, { waitUntil: "load" }); await page.waitForSelector("#root > *", { timeout: 15_000 }); // Protected routes need a session: start the local demo session once, so - // the reference feature really dispatches its (failing) API requests. - const login = page.getByRole("button", { name: /로그인 시작|Sign in|Start sign-in/u }); - if (await login.count()) { - await login.first().click(); + // the feature really dispatches its (failing) API requests. + // The prompt draws once the feature's context routes have loaded. + const login = page.getByRole("button", { name: /로그인 시작|Sign in|Start sign-in/u }).first(); + if (await login.waitFor({ timeout: 10_000 }).then(() => true, () => false)) { + await login.click(); await page.waitForTimeout(500); } @@ -412,8 +420,8 @@ export async function runBrowserSoak( let nextSample = 0; let cycles = 0; let navigationFailures = 0; - let referenceVisits = 0; - let settledReferenceVisits = 0; + let featureVisits = 0; + let settledFeatureVisits = 0; const probe = async () => (await page.evaluate(() => (window as unknown as { __soakProbe: () => Probe }).__soakProbe(), @@ -421,7 +429,7 @@ export async function runBrowserSoak( while (Date.now() - started < options.durationMs) { const route = options.routes[cycles % options.routes.length] ?? "/"; cycles += 1; - if (route === "/examples/reference-resources") referenceVisits += 1; + if (route === options.featureRoute) featureVisits += 1; // Client-side navigation keeps one long-lived document, like a real session. await page.evaluate((target) => { window.history.pushState({}, "", target); @@ -436,10 +444,10 @@ export async function runBrowserSoak( ); if (!rendered) navigationFailures += 1; // Most visits leave after 50ms, which cancels the query (a cancelled - // request is intentionally not reported). Every 5th reference visit + // request is intentionally not reported). Every 5th feature visit // dwells until its interaction settles, so the failing backend is really // observed end to end: bounded retries, then feature/platform telemetry. - if (route === "/examples/reference-resources" && referenceVisits % 5 === 1) { + if (route === options.featureRoute && featureVisits % 5 === 1) { await page.waitForTimeout(200); await page .waitForFunction( @@ -448,7 +456,7 @@ export async function runBrowserSoak( { timeout: 5_000 }, ) .catch(() => undefined); - settledReferenceVisits += 1; + settledFeatureVisits += 1; } const elapsedMs = Date.now() - started; if (elapsedMs >= nextSample) { @@ -483,8 +491,8 @@ export async function runBrowserSoak( { cycles, navigationFailures, - referenceVisits, - settledReferenceVisits, + featureVisits, + settledFeatureVisits, finalInFlightRequests, apiRequests: counters.apiRequests, telemetryPosts: counters.telemetryPosts, @@ -526,16 +534,23 @@ async function main(): Promise { const argument = (name: string, fallback: string) => process.argv.find((entry) => entry.startsWith(`--${name}=`))?.slice(name.length + 3) ?? fallback; const artifact = path.resolve(argument("artifact", "artifacts/scale/browser-soak.json")); + const ownBuild = argument("dist", ""); + const generated = ownBuild === "" ? await buildWithGeneratedFeature("browser-soak") : undefined; + const featureRoute = generated ? generated.feature.list.path : argument("feature-route", ""); + if (featureRoute === "") { + throw new Error("--dist needs --feature-route="); + } const result = await runBrowserSoak({ - distRoot: argument("dist", "dist"), + distRoot: generated?.dist ?? ownBuild, durationMs: Number(argument("duration-ms", "60000")), intervalMs: Number(argument("interval-ms", "5000")), warmupMs: Number(argument("warmup-ms", "15000")), routes: argument( "routes", - "/,/examples/reference-resources,/examples/platform,/examples/ui,/examples/states,/examples/reference-resources/status", + ["/", featureRoute, "/examples/platform", generated?.feature.create.path ?? "/not-found"].join(","), ).split(","), - }); + featureRoute, + }).finally(() => generated?.remove()); await mkdir(path.dirname(artifact), { recursive: true }); await writeFile(artifact, `${JSON.stringify(result, null, 2)}\n`); process.stdout.write( diff --git a/scripts/test-sample-removal.ts b/scripts/test-sample-removal.ts index 8c4dbc10..e60d011d 100644 --- a/scripts/test-sample-removal.ts +++ b/scripts/test-sample-removal.ts @@ -8,8 +8,10 @@ import { } from "node:fs/promises"; import { spawnSync } from "node:child_process"; import path from "node:path"; +import { fileURLToPath } from "node:url"; import { ROUTE_FEATURE_OWNER } from "../src/features/installed-feature-contracts.ts"; +import { loadCiGateContract } from "./contracts/ci-gates.ts"; import { createFileSystemDeclarationSource } from "./generate-product-feature-index.ts"; import { productFeatureResidue } from "./lib/feature-residue.ts"; import { isProductionModulePath } from "./lib/risk-coverage.ts"; @@ -32,42 +34,92 @@ import { import { REMOVABLE_TEMPLATE_FEATURES } from "./lib/removable-template-features.ts"; /** - * 09-07 (D-10). Removes one installed feature, `--feature=` (default: the - * reference sample), from a copy of the repository and proves the rest still - * typechecks, tests, covers and builds. Every feature loses its directory, its - * tests/features directory, its context when no other feature is left in it, - * its runtime-profile override and its central policy rows. The sample also - * owns the extra paths and scripts listed in SAMPLE_EXTRAS. + * 09-07 (D-10). Removes one installed feature, `--feature=`, from a copy + * of the repository and proves the rest still typechecks, tests, covers and + * builds. Every feature loses its directory, its tests/features directory, + * its context when no other feature is left in it, its runtime-profile + * override and its central policy rows. A sample that + * scripts/lib/removable-template-features.ts lists also loses its extra paths + * and package scripts, with the CI evidence only those scripts produce, and + * the copy then gets a feature from create:feature and runs the gates again. + * + * Without `--feature` (FE-GATE-020) each listed sample is removed in turn. + * The template lists none since its samples were deleted (2026-11-07): the + * run then reports the drill as skipped, not passed, and test:feature-scaffold + * removes a generated feature through `--feature`. */ -const featureId = - process.argv.find((argument) => argument.startsWith("--feature=")) - ?.slice("--feature=".length) ?? "reference-feature"; +const SAMPLE_REPORT = "artifacts/tests/sample-removal.xml"; +const requestedFeature = process.argv + .find((argument) => argument.startsWith("--feature=")) + ?.slice("--feature=".length); + +if (requestedFeature === undefined) { + const checks: RemovalCheck[] = REMOVABLE_TEMPLATE_FEATURES.map((sample) => { + const status = spawnSync( + process.execPath, + [fileURLToPath(import.meta.url), `--feature=${sample.featureId}`], + { stdio: "inherit" }, + ).status; + return status === 0 + ? { name: sample.featureId, passed: true } + : { + name: sample.featureId, + passed: false, + failure: `test:sample-removal -- --feature=${sample.featureId} exited ${status ?? "on a signal"}`, + }; + }); + await mkdir("artifacts/tests", { recursive: true }); + if (checks.length === 0) { + await writeFile( + SAMPLE_REPORT, + `\n` + + `` + + `` + + `\n`, + ); + process.stdout.write( + "sample removal: SKIP (scripts/lib/removable-template-features.ts lists no sample; " + + "test:feature-scaffold removes a generated feature with --feature)\n", + ); + } else { + await writeFile(SAMPLE_REPORT, renderRemovalJunit("sample-removal", checks)); + if (checks.some((check) => !check.passed)) process.exitCode = 1; + } + process.exit(); +} +const featureId: string = requestedFeature; type FeatureExtras = Readonly<{ paths: readonly string[]; ciScripts: readonly string[]; evidencePathFragments: readonly string[]; - residue: RegExp; }>; -// The sample's own files and scripts outside its folders are declared with -// the other removable template features, which verify:documentation reads too. -const REFERENCE_SAMPLE = REMOVABLE_TEMPLATE_FEATURES.find( - (feature) => feature.featureId === "reference-feature", -); -if (REFERENCE_SAMPLE === undefined) { - throw new Error("scripts/lib/removable-template-features.ts does not declare reference-feature"); +/** The CI evidence that only `scripts` produce: it goes with them. */ +async function evidenceOnlyFrom(scripts: readonly string[]): Promise { + if (scripts.length === 0) return []; + const contract = await loadCiGateContract(process.cwd()); + const commandIds = new Set( + contract.commands.filter(({ script }) => scripts.includes(script)).map(({ id }) => id), + ); + return contract.artifacts.flatMap((artifact) => + artifact.production === "command-generated" && + artifact.producerCommandIds.length > 0 && + artifact.producerCommandIds.every((commandId) => commandIds.has(commandId)) + ? [artifact.path] + : [], + ); } -const SAMPLE_EXTRAS: Readonly> = Object.freeze({ - "reference-feature": Object.freeze({ - paths: REFERENCE_SAMPLE.extraPaths, - ciScripts: REFERENCE_SAMPLE.scripts, - evidencePathFragments: [ - "reference-feature.xml", - ], - residue: /REFERENCE_RESOURCE|reference-feature|reference-resource/i, - }), +// The sample's own files and scripts outside its folders, which +// verify:documentation reads too. +const listedSample = REMOVABLE_TEMPLATE_FEATURES.find( + (feature) => feature.featureId === featureId, +); +const extras: FeatureExtras = Object.freeze({ + paths: listedSample?.extraPaths ?? [], + ciScripts: listedSample?.scripts ?? [], + evidencePathFragments: await evidenceOnlyFrom(listedSample?.scripts ?? []), }); function escapeRegExp(value: string): string { @@ -106,15 +158,6 @@ async function locateFeature(id: string) { } const located = await locateFeature(featureId); -const extras: FeatureExtras = SAMPLE_EXTRAS[featureId] ?? Object.freeze({ - paths: [], - ciScripts: [], - evidencePathFragments: [], - residue: new RegExp( - `${escapeRegExp(featureId)}|${escapeRegExp(located.directory)}`, - "i", - ), -}); // Captured from this repository before the copy loses them. const featureRouteIds = Object.entries(ROUTE_FEATURE_OWNER) .filter(([, owner]) => owner === featureId) @@ -124,7 +167,7 @@ const fixtureRoot = await createRemovalFixtureRoot(`${featureId}-removal`); const pnpmCli = requireRemovalFixtureEnvironment("npm_execpath"); const featureSource = `src/features/${located.directory}`; const featureTests = `tests/features/${located.directory}`; -const isSample = featureId in SAMPLE_EXTRAS; +const isSample = listedSample !== undefined; /** * Platform tests that must survive the sample feature's removal. Asserting they * are still present is what stops the removal fixture from "passing" by having @@ -281,12 +324,6 @@ try { const retainedCriticalModules = coveragePolicy.criticalModules.filter( (modulePolicy) => !modulePolicy.path?.startsWith(`${featureSource}/`), ); - if ( - isSample && - retainedCriticalModules.length === coveragePolicy.criticalModules.length - ) { - throw new Error("Reference feature coverage policy is not registered"); - } coveragePolicy.criticalModules = retainedCriticalModules; coveragePolicy.highRiskPaths = coveragePolicy.highRiskPaths.filter( (modulePath) => !modulePath.startsWith(`${featureSource}/`), @@ -299,7 +336,7 @@ try { ); coveragePolicy.repositoryBaseline -= removedProductionModuleCount; if (coveragePolicy.repositoryBaseline <= 0) { - throw new Error("Reference feature removal produced an invalid coverage baseline"); + throw new Error(`${featureId} removal produced an invalid coverage baseline`); } await writeFile( coveragePolicyFile, @@ -400,7 +437,7 @@ try { // JavaScript of the features installed now, and test:unit compares a build // with it. A product re-records it when it adds a feature; removing that // feature changes it again, so the fixture re-records it as the product - // would. The sample removal deletes the measurement with the sample. + // would. const measurement = path.join(fixtureRoot, "scripts/scale/measure-feature-shape-growth.ts"); if (await access(measurement).then(() => true, () => false)) { const measured = spawnSync( @@ -414,22 +451,13 @@ try { } await regenerateRemovalFixtureWorkflow(fixtureRoot); - const residue: string[] = []; - if (isSample) { - for (const root of ["src", "tests"]) { - for (const file of await filesBelow(path.join(fixtureRoot, root))) { - const relative = path.relative(fixtureRoot, file); - const content = await readFile(file, "utf8"); - if (extras.residue.test(`${relative}\n${content}`)) { - residue.push(relative); - } - } - } - } else { - // 1105/16-04. Template tests use example feature IDs as data; only what - // still points at the removed feature counts (scripts/lib/feature-residue.ts). - residue.push(...(await productFeatureResidue(fixtureRoot, featureId, located.directory))); - } + // 1105/16-04. Template tests use example feature IDs as data; only what + // still points at the removed feature counts (scripts/lib/feature-residue.ts). + const residue = await productFeatureResidue(fixtureRoot, featureId, located.directory); + const builtResiduePattern = new RegExp( + `${escapeRegExp(featureId)}|${escapeRegExp(located.directory)}`, + "i", + ); const missingCommonTests: string[] = []; for (const testPath of commonTestPaths) { @@ -471,7 +499,7 @@ try { for (const file of await filesBelow(path.join(fixtureRoot, "dist"))) { if (!/\.(?:js|css|html|json)$/.test(file)) continue; const content = await readFile(file, "utf8"); - if (extras.residue.test(content)) { + if (builtResiduePattern.test(content)) { builtResidue.push(path.relative(fixtureRoot, file)); } } @@ -493,9 +521,9 @@ try { outcome("built-fixture-id-residue", builtResidue, "built residue"), ); - // U7 (decision 4). The same copy, now without the sample, gets one feature - // from create:feature and runs the same gates again: the command and the - // feature it writes need nothing from the sample. + // U7 (decision 4). The same copy, now without the listed sample, gets one + // feature from create:feature and runs the same gates again: the command + // and the feature it writes need nothing from the sample. if (isSample) { // 1103/09-06. With the write slice (NEVER), which needs nothing from // the sample either. @@ -513,9 +541,7 @@ try { const failed = checks.filter((entry) => !entry.passed); await mkdir("artifacts/tests", { recursive: true }); await writeFile( - isSample - ? "artifacts/tests/sample-removal.xml" - : `artifacts/tests/feature-removal-${featureId}.xml`, + `artifacts/tests/feature-removal-${featureId}.xml`, renderRemovalJunit(`${featureId}-removal`, checks), ); if (failed.length > 0) { diff --git a/scripts/verify-documentation-readiness.ts b/scripts/verify-documentation-readiness.ts index 32f4b322..5f72f0df 100644 --- a/scripts/verify-documentation-readiness.ts +++ b/scripts/verify-documentation-readiness.ts @@ -187,15 +187,12 @@ const gateIds = new Set([ ).gates.map((gate) => gate.id), ...RETIRED_GATE_IDS, ]); -// 1105/14-01. A copy may delete the template features listed in -// scripts/lib/removable-template-features.ts, and the CHANGELOG tells -// tech-log to delete the example screens. The documents are the template's: -// a product that edited them to drop the feature's paths would conflict on -// every sync. While a feature is installed (its feature-module.ts exists), -// its paths and scripts are checked like any other; once it is not, they are -// not drift. tech-log keeps the reference sample's folder with its contracts -// but without its module, screens and tests (CHANGELOG "먼저 할 일" 1). A -// misspelt feature folder is not on the list and still fails. +// 1105/14-01. A copy may delete the sample features listed in +// scripts/lib/removable-template-features.ts (the template lists none since +// 2026-11-07). The documents may name a sample's paths: while it is installed +// (its feature-module.ts exists), its paths and scripts are checked like any +// other; once it is not, they are not drift. A misspelt feature folder is not +// on the list and still fails. const removedTemplateFeatures = REMOVABLE_TEMPLATE_FEATURES.filter( (feature) => !exists(`src/features/${feature.featureId}/feature-module.ts`), ); diff --git a/scripts/verify-extreme-scale.ts b/scripts/verify-extreme-scale.ts index 2fc9c913..8bffa3bb 100644 --- a/scripts/verify-extreme-scale.ts +++ b/scripts/verify-extreme-scale.ts @@ -35,7 +35,6 @@ export const EXTREME_SCALE_GATES = Object.freeze([ "check:observability", "check:release-coherence", "test:platform", - "test:reference-feature", "check:scale:pr", "check:scale:main", "check:scale:baseline", diff --git a/src/contexts/platform-examples-context/context-module.ts b/src/contexts/platform-examples-context/context-module.ts deleted file mode 100644 index 930b0859..00000000 --- a/src/contexts/platform-examples-context/context-module.ts +++ /dev/null @@ -1,12 +0,0 @@ -/** - * 1103/09-04. The template's example screens (UI gallery, screen states, - * auth integration) as one removable bounded context. A product leaves - * `platform-examples-feature` out of `VITE_PRODUCT_FEATURES`, or deletes it, - * and the three routes leave the registry, the navigation, the bundle and the - * manual accessibility list together. The root is `examples/*`; the sample - * feature's own context keeps a more specific path below it. - */ -export const CONTEXT_MODULE_ID = "platform-examples-context"; -export const CONTEXT_APP_ID = "template-app"; -export const CONTEXT_ROUTE_PATH = "examples/*"; -export const CONTEXT_MAX_FEATURES = 1; diff --git a/src/contexts/reference-context/context-module.ts b/src/contexts/reference-context/context-module.ts deleted file mode 100644 index 11c6996b..00000000 --- a/src/contexts/reference-context/context-module.ts +++ /dev/null @@ -1,10 +0,0 @@ -/** - * Ownership declaration of the reference bounded context (the rules are in - * docs/architecture/starter-experience.md, "Ownership declarations"): the app - * that owns it, its route root, and its direct-feature budget. Features name - * this id as their owner. - */ -export const CONTEXT_MODULE_ID = "reference-context"; -export const CONTEXT_APP_ID = "template-app"; -export const CONTEXT_ROUTE_PATH = "examples/reference-resources/*"; -export const CONTEXT_MAX_FEATURES = 200; diff --git a/src/features/platform-examples-feature/context-routes.ts b/src/features/platform-examples-feature/context-routes.ts deleted file mode 100644 index 1e332afe..00000000 --- a/src/features/platform-examples-feature/context-routes.ts +++ /dev/null @@ -1,17 +0,0 @@ -import type { RouteObject } from "react-router-dom"; - -import { PLATFORM_EXAMPLES_CONTRACT } from "./contracts/platform-examples-contract.ts"; -import { PLATFORM_EXAMPLES_ROUTE_RUNTIME } from "./presentation/platform-examples-runtime.ts"; - -export const FEATURE_CONTEXT_ROUTES: readonly RouteObject[] = Object.freeze( - Object.values(PLATFORM_EXAMPLES_CONTRACT.routes).map((definition) => - Object.freeze({ - id: definition.routeId, - path: definition.path, - handle: Object.freeze({ - routeId: definition.routeId, - runtime: PLATFORM_EXAMPLES_ROUTE_RUNTIME[definition.routeId], - }), - }), - ), -); diff --git a/src/features/platform-examples-feature/contracts/platform-examples-contract.ts b/src/features/platform-examples-feature/contracts/platform-examples-contract.ts deleted file mode 100644 index e98498e4..00000000 --- a/src/features/platform-examples-feature/contracts/platform-examples-contract.ts +++ /dev/null @@ -1,82 +0,0 @@ -export const PLATFORM_EXAMPLES_FEATURE_ID = "platform-examples-feature"; - -/** - * 1103/09-04. Three of the template's example screens, formerly fixed - * platform routes. The platform overview (`EXAMPLES_PLATFORM`) stays a - * platform route: the lab gate (FE-GATE-026) times entering it, and a feature - * route's first entry costs a second request round (its context's routes - * module, then the page). Paths, chunk ids and surfaces are unchanged: the - * visual and e2e tests and the manual accessibility records still name them. - * Declaration only, so it holds data; the pages load with `context-routes.ts`. - */ -export const PLATFORM_EXAMPLES_CONTRACT = Object.freeze({ - featureId: PLATFORM_EXAMPLES_FEATURE_ID, - routes: Object.freeze({ - EXAMPLES_UI: Object.freeze({ - routeId: "EXAMPLES_UI", - path: "/examples/ui", - paramsSchema: null, - searchSchema: null, - access: "public", - loadingSurface: "example-page", - errorSurface: "route-boundary", - chunkId: "route-examples-ui", - title: "UI 구성요소", - navigationLabel: "UI 구성요소", - navigationOrder: 20, - }), - EXAMPLES_STATES: Object.freeze({ - routeId: "EXAMPLES_STATES", - path: "/examples/states", - paramsSchema: null, - searchSchema: null, - access: "public", - loadingSurface: "example-page", - errorSurface: "route-boundary", - chunkId: "route-examples-states", - title: "화면 상태", - navigationLabel: "화면 상태", - navigationOrder: 30, - }), - EXAMPLES_AUTH: Object.freeze({ - routeId: "EXAMPLES_AUTH", - path: "/examples/auth", - paramsSchema: null, - searchSchema: null, - access: "public", - loadingSurface: "example-page", - errorSurface: "route-boundary", - chunkId: "route-examples-auth", - title: "인증 연동", - navigationLabel: "인증 연동", - navigationOrder: 40, - }), - }), - routeRuntimeContracts: Object.freeze({ - EXAMPLES_UI: Object.freeze({ - routeId: "EXAMPLES_UI", - moduleId: "ui-gallery-page", - paramsCodec: "none", - searchCodec: "none", - }), - EXAMPLES_STATES: Object.freeze({ - routeId: "EXAMPLES_STATES", - moduleId: "state-gallery-page", - paramsCodec: "none", - searchCodec: "none", - }), - EXAMPLES_AUTH: Object.freeze({ - routeId: "EXAMPLES_AUTH", - moduleId: "auth-example-page", - paramsCodec: "none", - searchCodec: "none", - }), - }), - invalidation: Object.freeze({ - topics: Object.freeze([]), - namespaces: Object.freeze([]), - edges: Object.freeze([]), - }), - topicVersions: Object.freeze([]), - contractPackages: Object.freeze([]), -} as const); diff --git a/src/features/platform-examples-feature/contracts/platform-examples-message-catalog.ts b/src/features/platform-examples-feature/contracts/platform-examples-message-catalog.ts deleted file mode 100644 index 310c98d4..00000000 --- a/src/features/platform-examples-feature/contracts/platform-examples-message-catalog.ts +++ /dev/null @@ -1,23 +0,0 @@ -/** - * 1103/09-04. The route titles and navigation labels the shell reads; they - * moved here from the platform catalog with the routes. The pages' own copy - * stays Korean in every locale (08-07). - */ -export const PLATFORM_EXAMPLES_MESSAGE_CATALOGS = Object.freeze({ - "ko-KR": Object.freeze({ - "route.EXAMPLES_UI.navigation": "UI 구성요소", - "route.EXAMPLES_UI.title": "UI 구성요소", - "route.EXAMPLES_STATES.navigation": "화면 상태", - "route.EXAMPLES_STATES.title": "화면 상태", - "route.EXAMPLES_AUTH.navigation": "인증 연동", - "route.EXAMPLES_AUTH.title": "인증 연동", - }), - "en-US": Object.freeze({ - "route.EXAMPLES_UI.navigation": "UI components", - "route.EXAMPLES_UI.title": "UI components", - "route.EXAMPLES_STATES.navigation": "Screen states", - "route.EXAMPLES_STATES.title": "Screen states", - "route.EXAMPLES_AUTH.navigation": "Authentication", - "route.EXAMPLES_AUTH.title": "Authentication", - }), -} as const); diff --git a/src/features/platform-examples-feature/feature-module.ts b/src/features/platform-examples-feature/feature-module.ts deleted file mode 100644 index 7d7b3fc4..00000000 --- a/src/features/platform-examples-feature/feature-module.ts +++ /dev/null @@ -1,27 +0,0 @@ -import { defineFeatureModule } from "../feature-module.ts"; -import { - PLATFORM_EXAMPLES_CONTRACT, - PLATFORM_EXAMPLES_FEATURE_ID, -} from "./contracts/platform-examples-contract.ts"; -import { PLATFORM_EXAMPLES_MESSAGE_CATALOGS } from "./contracts/platform-examples-message-catalog.ts"; - -export const FEATURE_MODULE_ID = - "platform-examples-feature" satisfies typeof PLATFORM_EXAMPLES_FEATURE_ID; -/** Owning bounded context (route root and budget live in its declaration). */ -export const FEATURE_CONTEXT_ID = "platform-examples-context"; - -/** - * 1103/09-04. The template's example screens as a feature, so the product's - * feature selection, `FEATURE_OVERRIDES`, the removal drill and the manual - * accessibility list apply to them like to any feature. Declaration only: - * the pages load with the context routes, and the runtime half is empty. - */ -export const PLATFORM_EXAMPLES_FEATURE_MODULE = defineFeatureModule({ - id: FEATURE_MODULE_ID, - contracts: PLATFORM_EXAMPLES_CONTRACT, - routes: PLATFORM_EXAMPLES_CONTRACT.routes, - messages: PLATFORM_EXAMPLES_MESSAGE_CATALOGS, - loadRuntime: async () => (await import("./feature-runtime.ts")).FEATURE_RUNTIME, -} as const); - -export const FEATURE_MODULE = PLATFORM_EXAMPLES_FEATURE_MODULE; diff --git a/src/features/platform-examples-feature/feature-runtime.ts b/src/features/platform-examples-feature/feature-runtime.ts deleted file mode 100644 index 7ab57e96..00000000 --- a/src/features/platform-examples-feature/feature-runtime.ts +++ /dev/null @@ -1,13 +0,0 @@ -import { defineFeatureRuntime } from "../feature-module.ts"; -import { PLATFORM_EXAMPLES_FEATURE_ID } from "./contracts/platform-examples-contract.ts"; - -/** - * 1103/09-04. The example screens call no feature API: they show the - * design system and the shell's session. The runtime half is empty. - */ -export const FEATURE_RUNTIME = defineFeatureRuntime({ - featureId: PLATFORM_EXAMPLES_FEATURE_ID, - schemas: Object.freeze({}), - adapters: [], - contractContributions: [], -} as const); diff --git a/src/features/platform-examples-feature/presentation/auth-example-page.tsx b/src/features/platform-examples-feature/presentation/auth-example-page.tsx deleted file mode 100644 index b7dcf908..00000000 --- a/src/features/platform-examples-feature/presentation/auth-example-page.tsx +++ /dev/null @@ -1,61 +0,0 @@ -import { PageHeader } from "../../../presentation/design-system/index.ts"; -import { - useSession, - useSessionAction, -} from "../../../presentation/providers/session-provider.tsx"; - -export default function AuthExamplePage() { - const { sessionState } = useSession(); - const { pending, failed, run } = useSessionAction(); - - return ( - // 08-07. Example copy is Korean in every locale (outside the catalog). -
- -
-
-

현재 세션 상태

- - {sessionState} - -
-
- - - -
- {sessionState === "integration-failed" ? ( -

- 외부 인증 소유자가 연결되지 않았습니다. 런타임 호스트의 인증 - 계약을 연결하세요. -

- ) : null} - {failed ?

인증 작업을 완료하지 못했습니다.

: null} -
-
- ); -} diff --git a/src/features/platform-examples-feature/presentation/platform-examples-runtime.ts b/src/features/platform-examples-feature/presentation/platform-examples-runtime.ts deleted file mode 100644 index 36447dd8..00000000 --- a/src/features/platform-examples-feature/presentation/platform-examples-runtime.ts +++ /dev/null @@ -1,17 +0,0 @@ -import { lazy } from "react"; - -/** One lazy chunk per example page, as when they were platform routes. */ -export const PLATFORM_EXAMPLES_ROUTE_RUNTIME = { - EXAMPLES_UI: Object.freeze({ - moduleId: "ui-gallery-page", - Component: lazy(() => import("./ui-gallery-page.tsx")), - }), - EXAMPLES_STATES: Object.freeze({ - moduleId: "state-gallery-page", - Component: lazy(() => import("./state-gallery-page.tsx")), - }), - EXAMPLES_AUTH: Object.freeze({ - moduleId: "auth-example-page", - Component: lazy(() => import("./auth-example-page.tsx")), - }), -} as const; diff --git a/src/features/platform-examples-feature/presentation/state-gallery-page.tsx b/src/features/platform-examples-feature/presentation/state-gallery-page.tsx deleted file mode 100644 index ceec9a9e..00000000 --- a/src/features/platform-examples-feature/presentation/state-gallery-page.tsx +++ /dev/null @@ -1,101 +0,0 @@ -import { useState } from "react"; - -import { deriveAsyncState } from "../../../application/view-models/async-state.ts"; -import { createFailure } from "../../../contracts/errors.ts"; -import { - AsyncSurface, - EmptySurface, - LoadingSurface, - TerminalErrorSurface, - AuthRequiredSurface, - ForbiddenSurface, - NotFoundSurface, - Button, - Card, - PageHeader, -} from "../../../presentation/design-system/index.ts"; - -export default function StateGalleryPage() { - const [lastAction, setLastAction] = useState( - "상태 화면의 작업을 선택하면 결과가 여기에 표시됩니다.", - ); - const refreshingState = deriveAsyncState({ - data: ["기존 데이터"], - isFetching: true, - }); - - return ( - // 08-07. Example copy is Korean in every locale (outside the catalog). -
- - -
-
-

비동기 데이터 상태

-

초기 로딩과 백그라운드 갱신을 구분해 기존 콘텐츠를 보존합니다.

-
-
- - - - - -
기존 콘텐츠는 계속 표시됩니다.
-
-
- - setLastAction("빈 화면 작업을 실행했습니다.")}> - 첫 작업 시작 - - } - /> - - - setLastAction("오류 요청을 다시 시도했습니다.")} - /> - -
-
- -
-
-

접근과 탐색 상태

-

인증 여부와 서버 권한 결과를 서로 다른 상태로 전달합니다.

-
-
- setLastAction("로그인 연동 작업을 시작했습니다.")} - /> - setLastAction("접근 가능한 화면으로 이동합니다.")} - /> - setLastAction("시작 화면으로 이동합니다.")} - /> -
-
- - - {lastAction} - -
- ); -} diff --git a/src/features/platform-examples-feature/presentation/ui-gallery-page.tsx b/src/features/platform-examples-feature/presentation/ui-gallery-page.tsx deleted file mode 100644 index 2a569382..00000000 --- a/src/features/platform-examples-feature/presentation/ui-gallery-page.tsx +++ /dev/null @@ -1,318 +0,0 @@ -import { useState, type FormEvent } from "react"; - -import { - Alert, - Badge, - Button, - Card, - Checkbox, - Dialog, - Menu, - PageHeader, - ProgressBar, - RadioGroup, - Select, - Switch, - Tabs, - TextArea, - TextField, - ToastProvider, - Tooltip, - useToast, -} from "../../../presentation/design-system/index.ts"; - -const COLOR_TOKENS = Object.freeze([ - ["Surface", "--color-surface"], - ["Muted surface", "--color-surface-muted"], - ["Content", "--color-content"], - ["Muted content", "--color-content-muted"], - ["Action", "--color-action"], - ["Danger", "--color-danger"], - ["Focus", "--color-focus"], -]); - -export default function UiGalleryPage() { - return ( - - - - ); -} - -function UiGalleryContent() { - const toast = useToast(); - const [projectName, setProjectName] = useState(""); - const [description, setDescription] = useState(""); - const [template, setTemplate] = useState("application"); - const [reviewed, setReviewed] = useState(false); - const [notifications, setNotifications] = useState(true); - const [density, setDensity] = useState("comfortable"); - const [fieldTouched, setFieldTouched] = useState(false); - const [dialogOpen, setDialogOpen] = useState(false); - const [notice, setNotice] = useState( - "구성요소를 조작하면 결과가 여기에 표시됩니다.", - ); - const [alertVisible, setAlertVisible] = useState(true); - const fieldError = - fieldTouched && projectName.trim().length === 0 - ? "프로젝트 이름을 입력해 주세요." - : undefined; - - function submitExample(event: FormEvent): void { - event.preventDefault(); - setFieldTouched(true); - if (projectName.trim().length === 0) { - setNotice("입력값을 확인해 주세요."); - return; - } - setNotice(`“${projectName.trim()}” 입력을 확인했습니다.`); - } - - return ( - // 08-07. Example copy is Korean in every locale (outside the catalog). -
- - -
-
-

버튼과 입력

-

키보드, 비활성 상태, 오류 설명을 포함한 기본 상호작용입니다.

-
-
- -
- - - - -
-
- -
- setProjectName(event.currentTarget.value)} - /> - - -
-
-
- -
-
-

폼과 선택 컨트롤

-

native semantics, 설명·오류 연결과 controlled 상태를 제공합니다.

-
-
- -
-