egovframe-scaffold-mcp 0.26.0 → 0.27.0

package/README.md

@@ -11,11 +11,11 @@
 Claude, VS Code(Copilot), Cursor 등 MCP를 지원하는 AI 도구에서 **대화 중 즉시** 표준프레임워크
 프로젝트를 만들고 공통컴포넌트·AI 계층을 조립할 수 있습니다. 기존 프로젝트 진단, 리포트, 안전한 upstream 재동기화도 지원합니다.
 
-현재 v0.26.0은 **도구 22종, 공식 템플릿 10종, 공통컴포넌트 카탈로그 190항목(리프 176종+그룹 14종)**을 제공합니다.
+현재 v0.27.0은 **도구 22종, 공식 템플릿 22종, 공통컴포넌트 카탈로그 190항목(리프 176종+그룹 14종)**을 제공합니다.
 
 ## 진행 현황 (2026-09-13)
 
-- **소스 기준**: v0.26.0(`package.json`), 도구 22종·공식 템플릿 10종·카탈로그 190항목.
+- **소스 기준**: v0.27.0(`package.json`), 도구 22종·공식 템플릿 22종·카탈로그 190항목.
 - **안전성 기준선 완료**: [PR #7](https://github.com/EricSeokgon/egovframe-scaffold-mcp/pull/7)~[#16](https://github.com/EricSeokgon/egovframe-scaffold-mcp/pull/16)을 반영해 provenance·strict assertion·safe remove와 프로젝트 생성/레시피/직접 조립/AI 조립/업그레이드 transaction을 갖췄습니다.
 - **v0.22.0 추가**: `EGOVFRAME_ALLOWED_ROOTS`를 19개 도구 진입점에 적용해 `..`·symlink/junction 이탈을 차단하고, 실패 시 rollback 결과를 구조화해 반환합니다. [PR #16](https://github.com/EricSeokgon/egovframe-scaffold-mcp/pull/16)은 7파일(+340/−31), 로컬 16종 스위트 전체 통과 후 병합됐습니다.
 - **v0.23.0 추가**: `build_egovframe_project` — 생성한 프로젝트를 실제로 빌드(maven/gradle·mvnw/gradlew 자동 감지)하고 컴파일·테스트 오류를 파일/라인 단위로 구조화해 생성→검증 루프를 완성합니다. 타임아웃·로그 상한·허용 root·dryRun 포함. [PR #18](https://github.com/EricSeokgon/egovframe-scaffold-mcp/pull/18)은 4파일(+458/−3), 오프라인 40단언과 실제 spawn 경로를 검증했습니다.
@@ -24,6 +24,7 @@ Claude, VS Code(Copilot), Cursor 등 MCP를 지원하는 AI 도구에서 **대
 - **v0.25.2 추가**: 보안·안정성 보강 — `generate_egovframe_ci`의 `jdk` 입력 검증(생성 YAML 주입 차단), 빌드·테스트 타임아웃 시 프로세스 트리 종료(래퍼가 띄운 JVM 때문에 타임아웃이 걸려도 호출이 끝나지 않던 문제 해결), MCP handshake 서버 버전을 `package.json`과 일치, 의존성 갱신으로 `npm audit` 0건.
 - **v0.25.3 추가**: Linux·macOS에서 `npx egovframe-scaffold-mcp`(bin symlink 경유) 실행 시 서버가 기동하지 않고 종료되던 문제 수정, CI를 ubuntu·windows × Node 18·20·22 매트릭스로 확장.
 - **v0.26.0 추가**: `sync_egovframe_templates` + `catalog/templates.json` — 그동안 Initializr(프로젝트 22종 zip 카탈로그)·MCP(`TEMPLATES` 10종 저장소 조달)·Development(`wizards.xml` 설정 마법사)에 흩어져 있던 "어떤 공식 프로젝트가 있는가"를 하나의 스키마로 합쳤습니다. 매핑은 `catalog/template-mapping.json` 에서 큐레이션하고(자동 추론 없음), upstream 과의 추가·삭제·변경과 MCP 커버리지 격차(현재 22종 중 9종 대응)를 도구로 조회합니다. 오프라인 148단언(`npm run test:template-catalog`).
+- **v0.27.0 추가**: 공식 템플릿 커버리지 10 → **22종**(Initializr 22종 기준 대응 9 → 21종). 단독 저장소가 없는 배치 6종·빈 골격(`web`·`boot-web`)·모바일 2종·MSA 포털 2종을 Initializr 의 zip(Git LFS)으로 조달하며, commit 과 sha256·크기를 고정해 내려받은 바이트를 검증합니다. `sync_egovframe_templates` 가 zip 지문의 upstream 변화도 함께 보고합니다(설계: [docs/design-initializr-zip-templates.md](docs/design-initializr-zip-templates.md)).
 - **배포 상태**: npm 최신 배포 버전은 상단 npm 배지와 [npm 패키지 페이지](https://www.npmjs.com/package/egovframe-scaffold-mcp)를 단일 출처로 확인합니다. 이 문서의 버전 표기는 저장소 소스(`package.json`) 기준이며, git 태그 `vX.Y.Z`가 해당 배포본의 커밋을 가리킵니다.
 
 ## 제공 도구
@@ -51,18 +52,19 @@ Claude, VS Code(Copilot), Cursor 등 MCP를 지원하는 AI 도구에서 **대
 | `build_egovframe_project` | 생성한 프로젝트를 실제로 빌드(compile·test·package) — maven/gradle·mvnw/gradlew 자동 감지, 타임아웃·로그 상한, 컴파일 오류 파일/라인 구조화, dryRun |
 | `test_egovframe_project` | 테스트 실행 + JUnit XML 리포트(surefire·gradle) 구조화 — 스위트별 통과/실패/오류/건너뜀, 실패 케이스 메시지·예외 타입·테스트 파일/라인, `testFilter`, 이전 실행 리포트 제외, dryRun |
 | `generate_egovframe_crud` | 공식 Development CRUD wizard 입력 체계 기반 코드 생성 — VO·Mapper(XML)·Service·Controller·JSP(선택)·JUnit 5(선택), Classic/Boot 분기, 전체 충돌 사전 검사 |
-| `sync_egovframe_templates` | 공식 프로젝트 템플릿 통합 카탈로그(Initializr·MCP·Development) upstream 대조 — 추가/삭제/변경 항목과 MCP 커버리지 격차 보고, 네트워크 필요 |
+| `sync_egovframe_templates` | 공식 프로젝트 템플릿 통합 카탈로그(Initializr·MCP·Development) upstream 대조 — 추가/삭제/변경 항목과 MCP 커버리지 격차, zip 조달 템플릿의 고정 지문(sha256·크기) 변화 보고, 네트워크 필요 |
 
 ### create_egovframe_project 파라미터
 
 - `projectName` — 프로젝트명(artifactId). 소문자·숫자·하이픈 (예: `my-egov-app`)
 - `groupId` — 자바 groupId (예: `egovframework.example`)
 - `database` — `hsql`(기본) | `mysql` | `oracle` | `altibase` | `tibero` (템플릿 `Globals.DbType` 지원 값)
-- `template` — `simple-backend`(기본, Spring Boot REST) | `simple-react` | `simple-homepage` | `portal-site` | `enterprise-business` | `web-sample` | `msa-edu` | `msa-common-components` | `mobile-device-api` | `ai-rag` (전체 10종, `list_egovframe_templates`로 확인)
+- `template` — `simple-backend`(기본, Spring Boot REST) | `simple-react` | `simple-homepage` | `portal-site` | `enterprise-business` | `web-sample` | `msa-edu` | `msa-common-components` | `mobile-device-api` | `ai-rag` | `web` | `boot-web` | `batch-file-scheduler` | `batch-file-commandline` | `batch-file-web` | `batch-db-scheduler` | `batch-db-commandline` | `batch-db-web` | `mobile-web` | `mobile-common-components` | `msa-portal-backend` | `msa-portal-frontend` (전체 22종, `list_egovframe_templates`로 확인)
   - 레거시 템플릿(simple-homepage·portal-site·enterprise-business·web-sample)은 `egovProps/globals.properties`의 `Globals.DbType`에 DB 타입을 적용합니다.
   - `msa-edu`·`msa-common-components`·`mobile-device-api`·`ai-rag`는 멀티 프로젝트라 좌표·DB 자동 적용 없이 원본 그대로 생성하고 README 안내를 반환합니다.
+  - `web`부터 `msa-portal-frontend`까지 12종은 **Initializr zip 조달** 템플릿입니다. 고정 commit 의 zip 을 받아 sha256·크기를 검증한 뒤 `pom.xml` 의 `###GROUP_ID###` 등 자리표시자를 채우고, `globals.properties`(배치는 `egovframework/batch/properties/`)에 DB 타입을 적용합니다. `msa-portal-*` 2종은 멀티 프로젝트라 자동 적용이 없습니다.
 - `outputDir` — 생성 위치 상위 디렉터리
-- `ref` — (선택) 내려받을 브랜치/태그. 미지정 시 템플릿 기본 브랜치. 예: `main`, `v4.3.0`
+- `ref` — (선택) 내려받을 브랜치/태그. 미지정 시 템플릿 기본 브랜치. 예: `main`, `v4.3.0` zip 조달 템플릿에 `ref`를 주면 고정 지문 검증을 건너뛰며 결과에 그 사실이 표시됩니다.
 - `dryRun` — (선택, 기본 `false`) `true`면 디스크에 쓰지 않고 생성 예정 파일 수·적용 설정만 미리보기
 
 동작: 공식 템플릿 zip 다운로드 → 압축 해제(zip-slip 방지) → `pom.xml`의 groupId/artifactId/name 적용(부모 POM 좌표는 유지) → `application.properties`의 `Globals.DbType` 설정, 프론트엔드 템플릿은 `package.json`의 `name` 설정. 기존 디렉터리가 있으면 거부합니다. 다운로드에는 30초 타임아웃이 적용되어 무응답 시 무한 대기하지 않습니다. `dryRun`으로 먼저 안전하게 미리볼 수 있습니다.
@@ -190,7 +192,8 @@ Claude Desktop / Claude Code 설정 예 (`mcpServers`):
 - 함수 레벨: 실제 템플릿(약 296파일) 생성, pom 좌표·DbType 적용, 중복 생성 거부, `dryRun` 미리보기(무기록) 확인 (`npm run smoke`)
 - Maven 좌표 레벨: 프로젝트 직접 groupId/artifactId/name만 변경하고 parent·dependency artifactId 보존 (`npm run test:pom`, 네트워크 불필요)
 - 카탈로그 레벨: schema v2, 고정 source/archive 지문, 자산 메타데이터, 무결성·위상 정렬·미리보기 검증 (`npm run test:catalog`, `npm run test:catalog-sync`, 네트워크 불필요)
-- 템플릿 카탈로그 레벨: `catalog/templates.json` 스키마·커버리지 계산·큐레이션 매핑 정합·변환기·upstream 차이 계산(추가/삭제/필드 변경) 검증 (`npm run test:template-catalog`, 148단언, 네트워크 불필요)
+- zip 조달 레벨: 자리표시자 치환·globals 경로 판별·12종 정의 유효성(`npm run test:pom`, 네트워크 불필요), `batch-file-commandline` 실생성으로 지문 검증·좌표·DbType·zip 루트 보존, 지문 불일치 거부와 무기록, `ref` 지정 시 검증 생략 표시(`npm run test:templates`, 네트워크 필요, CI 실행)
+- 템플릿 카탈로그 레벨: `catalog/templates.json` 스키마·커버리지 계산·큐레이션 매핑 정합·변환기·upstream 차이 계산(추가/삭제/필드 변경) 검증 (`npm run test:template-catalog`, 247단언, zip 지문 drift·LFS 포인터 해석 포함, 네트워크 불필요)
 - 동기화 레벨: 공식 v5.0.6 태그→commit, SHA-256·크기·파일 수, `sec.security`, 미매핑 경로 0건 검증 (`npm run test:catalog-sync-live`, 네트워크 필요)
 - 조립 레벨: 실제 공통컴포넌트 저장소로 bbs+login+sec.security(+cmm) 843파일 조립, message·IDGN·웹 자산·공용 fragment·Maven 좌표·선별 DB 스크립트·충돌 전체 거부·파일/SQL/매니페스트 fault-injection rollback·상위 symlink 경계 검증 (`npm run test:components`)
 - 수명주기 레벨: 설치 매니페스트 기록, 중복 설치 거부, 의존 컴포넌트 제거 보호, 제거·검증 동작 (`npm run test:components`)
@@ -213,11 +216,11 @@ Claude Desktop / Claude Code 설정 예 (`mcpServers`):
 - 카탈로그는 공식 v5.0.6 태그·commit·archive 지문에 고정됩니다. 최신 main 변경은 `sync_egovframe_catalog(ref="main")` 결과를 검토한 뒤 생성 스크립트로 승격합니다.
 - `build_egovframe_project`·`test_egovframe_project`는 로컬에 설치된 JDK와 maven/gradle(또는 프로젝트 래퍼)을 사용합니다. DB 등 외부 의존성이 필요한 테스트는 그 환경이 준비되지 않으면 오류(error)로 집계됩니다.
 - 자바 패키지 구조 변경(groupId에 맞춘 소스 디렉터리 이동)은 미지원입니다. 현재는 IDE rename refactoring을 권장합니다.
-- 템플릿·컴포넌트·가이드 원본을 받을 때 GitHub(`codeload.github.com`, `raw.githubusercontent.com`) 네트워크 접근이 필요합니다.
+- 템플릿·컴포넌트·가이드 원본을 받을 때 GitHub(`codeload.github.com`, `raw.githubusercontent.com`, zip 조달 템플릿은 `media.githubusercontent.com`) 네트워크 접근이 필요합니다.
 
 ## 로드맵
 
-v0.26.0까지 프로젝트·CRUD 생성, 검증된 공통컴포넌트 실행 자산 조립, 안전성 기반(테스트 판정 강제·사용자 파일 보호·전 도구 트랜잭션·허용 root·구조화 rollback 보고), 생성→검증 루프(실제 빌드·오류 구조화·테스트 리포트 구조화), 그리고 공식 템플릿 카탈로그 단일화를 완료했습니다.
+v0.27.0까지 프로젝트·CRUD 생성, 검증된 공통컴포넌트 실행 자산 조립, 안전성 기반(테스트 판정 강제·사용자 파일 보호·전 도구 트랜잭션·허용 root·구조화 rollback 보고), 생성→검증 루프(실제 빌드·오류 구조화·테스트 리포트 구조화), 그리고 공식 템플릿 카탈로그 단일화와 커버리지 확대(22종 중 21종)를 완료했습니다.
 
 | 버전 | 핵심 기능 | 목표 |
 |---|---|---|
@@ -228,9 +231,10 @@ v0.26.0까지 프로젝트·CRUD 생성, 검증된 공통컴포넌트 실행 자
 | **v0.24 완료** | 공식 템플릿 커버리지 확대 (7 → **10종**) | Initializr 카탈로그(22항목) 대조로 미커버 공식 자산을 식별해 `msa-common-components`(KRDS)·`mobile-device-api`·`ai-rag` 추가. 모두 멀티 프로젝트로 표시해 좌표/DB 자동 재작성을 건너뛰고 하위 모듈 참조를 보호하며, 실제 아카이브 다운로드 통합 테스트로 검증 |
 | **v0.25 완료** | `test_egovframe_project` | 테스트 실행 후 JUnit XML 리포트(surefire `target/surefire-reports`, gradle `build/test-results/test`)를 읽어 스위트·케이스 단위 집계, 실패 메시지·예외 타입·테스트 파일/라인, `testFilter`, 오래된 리포트 제외, exit 0이어도 리포트 실패면 실패 판정 |
 | **v0.26 완료** | IDE·Initializr·MCP 공통 카탈로그 | Initializr `templates-projects.json`(22종), MCP `TEMPLATES`(10종), Development `wizards.xml`(8카테고리)을 `schemaVersion: 1` 단일 스키마 `catalog/templates.json` 으로 통합. 변환기(`fromInitializr`·`fromMcpTemplates`)와 큐레이션 매핑(`catalog/template-mapping.json`), upstream 대조 도구 `sync_egovframe_templates` 로 커버리지 격차를 수작업 비교 없이 확인 |
-| **v0.27 후보** | `migrate_egovframe_namespace` | 3.x→4.x import·XML bean·빌드 좌표 전환. dryRun·백업·원자적 거부와 자동 변환 불가 API 보고 |
-| **v0.28 후보** | `check_egovframe_dependencies` + `security_patch_advisor` | 폐쇄망 최소 버전 규칙과 선택적 CVE 조회, CSRF·보안 설정·공식 패치 기준 점검 |
-| **v0.29+ 후보** | 접근성·배포·AI 컨텍스트 | 영문 응답/README, Homebrew·MCP Registry, `generate_agents_md`, 공식 템플릿 커버리지 확대 |
+| **v0.27 완료** | 공식 템플릿 커버리지 확대 (10 → **22종**) | 통합 카탈로그가 계산한 미커버 13종 중 12종을 Initializr zip(Git LFS) 조달로 추가. commit·sha256·크기 고정과 다운로드 검증, pom 자리표시자 치환, 템플릿별 `globals.properties` 경로 대응, `sync_egovframe_templates` 의 zip 지문 drift 보고 |
+| **v0.28 후보** | `migrate_egovframe_namespace` | 3.x→4.x import·XML bean·빌드 좌표 전환. dryRun·백업·원자적 거부와 자동 변환 불가 API 보고 |
+| **v0.29 후보** | `check_egovframe_dependencies` + `security_patch_advisor` | 폐쇄망 최소 버전 규칙과 선택적 CVE 조회, CSRF·보안 설정·공식 패치 기준 점검 |
+| **v0.30+ 후보** | 접근성·배포·AI 컨텍스트·설정 생성 | 영문 응답/README, Homebrew·MCP Registry, `generate_agents_md`, Initializr 설정 템플릿(datasource·transaction·cache 등 21종) 기반 `generate_egovframe_config` |
 
 로드맵 근거:
 
@@ -244,6 +248,7 @@ v0.26.0까지 프로젝트·CRUD 생성, 검증된 공통컴포넌트 실행 자
 
 ## 변경 이력
 
+- **0.27.0** — 공식 템플릿 커버리지 확대(10 → **22종**, Initializr 22종 기준 대응 9 → 21종): v0.26.0 의 통합 카탈로그가 계산해 준 미커버 13종 가운데, 단독 GitHub 저장소 없이 Initializr 저장소의 zip(Git LFS, `templates/projects/examples/`)으로만 배포되는 12종을 추가했습니다 — `web`·`boot-web`(빈 골격), `batch-file-scheduler`·`batch-file-commandline`·`batch-file-web`·`batch-db-scheduler`·`batch-db-commandline`·`batch-db-web`, `mobile-web`·`mobile-common-components`, `msa-portal-backend`·`msa-portal-frontend`(멀티 프로젝트). 브랜치는 움직이므로 Initializr **commit** 으로 다운로드 URL 을 고정하고 LFS 포인터의 **sha256·크기**로 내려받은 바이트를 검증하며, 다르면 아무것도 쓰지 않고 거부합니다(`ref` 를 직접 주면 검증을 건너뛰고 결과에 `archiveVerified: false` 와 경고를 남깁니다). zip 은 codeload 아카이브와 달리 최상위 폴더가 없어 루트를 잘라내지 않고, `pom.xml` 의 `###GROUP_ID###`·`###ARTIFACT_ID###`·`###NAME###`·`###VERSION###`·`###URL###` 자리표시자를 채운 뒤 기존 좌표 적용을 거칩니다. `Globals.DbType` 은 템플릿마다 다른 `globals.properties` 경로(배치는 `egovframework/batch/properties/`)를 찾아 적용합니다. `sync_egovframe_templates` 는 zip 본문 대신 LFS 포인터만 읽어 고정 지문과 대조한 `archivesChecked`·`archiveDrift` 를 보고하고, 통합 카탈로그의 `mcp.archive` 에 지문을 함께 싣습니다. 23MB 올인원인 `egov-template-common-components` 는 "공통컴포넌트는 `add_egovframe_components` 로 선택 조립한다"는 기존 큐레이션 결정에 따라 제외했습니다. 12종 전부 실생성해 자리표시자 0건을 확인했고 `batch-db-commandline`·`boot-web`·`mobile-web` 은 `mvn compile` 을 통과했습니다. zip 본문을 받기 위해 `media.githubusercontent.com` 접근이 추가로 필요합니다. 기존 10종·전체 도구 하위 호환. 로드맵의 후보 번호는 한 칸씩 뒤로 옮겼습니다(namespace 전환 v0.27 → v0.28 등).
 - **0.26.0** — 공식 템플릿 카탈로그 단일화: `sync_egovframe_templates` 추가(도구 21 → 22). 그동안 같은 사실이 세 곳에 따로 적혀 있었습니다 — Initializr 는 `templates/templates-projects.json` 에 프로젝트 22종을 zip·pom 스냅샷으로, MCP 는 `TEMPLATES`(현 `src/project.ts`)에 10종을 공식 저장소 조달 방식으로, Development 는 `eGovFrameTemplates/wizards.xml` 에 설정 스니펫 마법사 8카테고리를 담고 있었고, v0.24.0 의 커버리지 확대도 이 둘을 **사람이 눈으로 대조**해 진행했습니다. 이번에 `schemaVersion: 1` 의 `catalog/templates.json` 하나로 합쳐 프로젝트마다 Initializr 쪽 zip·pom 과 MCP 쪽 저장소·브랜치·멀티프로젝트 여부를 나란히 두고, 커버리지(22종 중 대응 9종·미커버 13종·MCP 단독 2종)를 계산된 값으로 기록합니다. 매핑은 `catalog/template-mapping.json` 에서 큐레이션하며 자동 추론하지 않습니다 — 예컨대 Initializr 의 `egov-web`(빈 웹 골격)과 MCP 의 `web-sample`(게시판 샘플)은 이름이 비슷해도 다른 산출물이라 대응시키지 않고 근거를 note 로 남겼습니다. 생성기 `scripts/generate-template-catalog.mjs` 는 매핑에 없는 upstream 항목을 만나면 실패해 조용한 누락을 막고, `sync_egovframe_templates` 는 upstream 을 내려받아 추가·삭제·변경(필드 단위)과 sha256 을 대조해 보고하되 파일을 고쳐 쓰지 않습니다. `list_egovframe_templates` 응답에도 커버리지 요약이 붙습니다(카탈로그가 없으면 기존 동작 유지). 오프라인 148단언(`npm run test:template-catalog`), 기존 21개 도구 하위 호환. 생성기는 Windows 에서도 동작하도록 `dist/index.js` 로드와 직접 실행 판정을 file URL·realpath 기준으로 처리합니다.
 - **0.25.3** — 기동 버그 수정 + CI 확장(도구 인터페이스 하위 호환).
   - **npx 기동 실패 수정(Linux·macOS)**: 진입점 판정이 `process.argv[1]`의 파일명 끝을 `import.meta.url`과 비교하는 방식이어서, npm이 POSIX에서 bin을 symlink(`node_modules/.bin/egovframe-scaffold-mcp → dist/index.js`)로 설치하면 진입점이 아니라고 판단해 서버를 띄우지 않고 오류 없이 종료했습니다. README가 안내하는 `npx -y egovframe-scaffold-mcp` 설정이 Linux·macOS에서 동작하지 않던 원인입니다(Windows는 `.cmd` shim이 `dist/index.js`를 직접 실행해 영향 없음, `node dist/index.js` 직접 실행도 영향 없음). 양쪽 경로를 realpath로 풀어 비교하도록 바꾸고, symlink 경유 기동을 회귀 테스트로 고정했습니다(`npm run test:handshake`).

package/catalog/template-mapping.json

@@ -1,13 +1,27 @@
 {
   "comment": "Initializr 프로젝트(projectName)와 MCP 템플릿(TEMPLATES 키)의 큐레이션 매핑. 같은 공식 산출물을 가리킬 때만 mcpTemplate 을 채우고, 성격이 다르면 null 로 두고 note 에 근거를 남긴다. scripts/generate-template-catalog.mjs 가 읽는다.",
   "mappings": {
-    "egov-template-simple": { "mcpTemplate": "simple-homepage" },
-    "egov-template-portal": { "mcpTemplate": "portal-site" },
-    "egov-template-enterprise": { "mcpTemplate": "enterprise-business" },
-    "egov-boot-simple-backend": { "mcpTemplate": "simple-backend" },
-    "egov-boot-simple-frontend": { "mcpTemplate": "simple-react" },
-    "egov-msa-boot-common-components": { "mcpTemplate": "msa-common-components" },
-    "egov-mobile-deviceapi": { "mcpTemplate": "mobile-device-api" },
+    "egov-template-simple": {
+      "mcpTemplate": "simple-homepage"
+    },
+    "egov-template-portal": {
+      "mcpTemplate": "portal-site"
+    },
+    "egov-template-enterprise": {
+      "mcpTemplate": "enterprise-business"
+    },
+    "egov-boot-simple-backend": {
+      "mcpTemplate": "simple-backend"
+    },
+    "egov-boot-simple-frontend": {
+      "mcpTemplate": "simple-react"
+    },
+    "egov-msa-boot-common-components": {
+      "mcpTemplate": "msa-common-components"
+    },
+    "egov-mobile-deviceapi": {
+      "mcpTemplate": "mobile-device-api"
+    },
     "egov-ai-rag-springai": {
       "mcpTemplate": "ai-rag",
       "note": "MCP 의 ai-rag 는 spring-ai·langchain4j 두 모듈을 함께 담은 멀티 프로젝트라 Initializr 의 두 항목이 같은 템플릿에 대응한다"
@@ -17,27 +31,60 @@
       "note": "MCP 의 ai-rag 는 spring-ai·langchain4j 두 모듈을 함께 담은 멀티 프로젝트라 Initializr 의 두 항목이 같은 템플릿에 대응한다"
     },
     "egov-web": {
-      "mcpTemplate": null,
-      "note": "빈 웹 프로젝트 골격이다. MCP 의 web-sample(egovframe-web-sample)은 게시판 샘플이라 같은 산출물로 보지 않는다"
+      "mcpTemplate": "web",
+      "note": "빈 웹 프로젝트 골격 — Initializr zip 으로 조달한다. 게시판 샘플인 web-sample(egovframe-web-sample)과는 다른 산출물이라 따로 둔다"
+    },
+    "egov-boot-web": {
+      "mcpTemplate": "boot-web",
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
     },
-    "egov-boot-web": { "mcpTemplate": null },
     "egov-template-common-components": {
       "mcpTemplate": null,
       "note": "공통컴포넌트 올인원 프로젝트. MCP 는 템플릿 통째로 받는 대신 list_egovframe_components / add_egovframe_components 로 선택 조립한다"
     },
-    "egov-msa-portal-backend": { "mcpTemplate": null },
-    "egov-msa-portal-frontend": { "mcpTemplate": null },
-    "egov-mobile-web": { "mcpTemplate": null },
-    "egov-mobile-common-components": { "mcpTemplate": null },
-    "egov-boot-batch-scheduler-file": { "mcpTemplate": null },
-    "egov-boot-batch-commandline-file": { "mcpTemplate": null },
-    "egov-boot-batch-web-file": { "mcpTemplate": null },
-    "egov-boot-batch-scheduler-db": { "mcpTemplate": null },
-    "egov-boot-batch-commandline-db": { "mcpTemplate": null },
-    "egov-boot-batch-web-db": { "mcpTemplate": null }
+    "egov-msa-portal-backend": {
+      "mcpTemplate": "msa-portal-backend",
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
+    },
+    "egov-msa-portal-frontend": {
+      "mcpTemplate": "msa-portal-frontend",
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
+    },
+    "egov-mobile-web": {
+      "mcpTemplate": "mobile-web",
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
+    },
+    "egov-mobile-common-components": {
+      "mcpTemplate": "mobile-common-components",
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
+    },
+    "egov-boot-batch-scheduler-file": {
+      "mcpTemplate": "batch-file-scheduler",
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
+    },
+    "egov-boot-batch-commandline-file": {
+      "mcpTemplate": "batch-file-commandline",
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
+    },
+    "egov-boot-batch-web-file": {
+      "mcpTemplate": "batch-file-web",
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
+    },
+    "egov-boot-batch-scheduler-db": {
+      "mcpTemplate": "batch-db-scheduler",
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
+    },
+    "egov-boot-batch-commandline-db": {
+      "mcpTemplate": "batch-db-commandline",
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
+    },
+    "egov-boot-batch-web-db": {
+      "mcpTemplate": "batch-db-web",
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
+    }
   },
   "mcpOnlyNotes": {
-    "web-sample": "Initializr 의 egov-web 은 빈 골격이라 대응 항목으로 보지 않는다",
+    "web-sample": "게시판 샘플 저장소. Initializr 의 egov-web(빈 골격)은 MCP 의 web 템플릿에 대응한다",
     "msa-edu": "Initializr 카탈로그에 없는 MCP 단독 템플릿(클라우드 네이티브 교육용 멀티 프로젝트)"
   }
 }

package/catalog/templates.json

@@ -21,14 +21,14 @@
     },
     "mcp": {
       "source": "src/project.ts TEMPLATES",
-      "templates": 10
+      "templates": 22
     }
   },
   "coverage": {
     "initializrProjects": 22,
-    "coveredByMcp": 9,
-    "uncovered": 13,
-    "mcpTemplates": 10,
+    "coveredByMcp": 21,
+    "uncovered": 1,
+    "mcpTemplates": 22,
     "mcpOnly": 2
   },
   "projects": [
@@ -41,9 +41,20 @@
         "fileName": "egovframe-web.zip",
         "pomFile": "egovframe-web-pom.xml"
       },
-      "mcpTemplate": null,
-      "mcp": null,
-      "note": "빈 웹 프로젝트 골격이다. MCP 의 web-sample(egovframe-web-sample)은 게시판 샘플이라 같은 산출물로 보지 않는다"
+      "mcpTemplate": "web",
+      "mcp": {
+        "repository": "eGovFramework/egovframe-vscode-initializr",
+        "branch": "main",
+        "multiProject": false,
+        "archive": {
+          "kind": "initializr-zip",
+          "commit": "f8f572596e0c19d7992b132298992d5ce56ea819",
+          "path": "templates/projects/examples/egovframe-web.zip",
+          "sha256": "13674f6f76e74e6d70478b7e9ad0689b0f84b5ffc9828a49f8b511dc2b3d6b69",
+          "bytes": 15547491
+        }
+      },
+      "note": "빈 웹 프로젝트 골격 — Initializr zip 으로 조달한다. 게시판 샘플인 web-sample(egovframe-web-sample)과는 다른 산출물이라 따로 둔다"
     },
     {
       "id": "egov-template-simple",
@@ -115,8 +126,20 @@
         "fileName": "egovframe-boot-web.zip",
         "pomFile": "egovframe-boot-web-pom.xml"
       },
-      "mcpTemplate": null,
-      "mcp": null
+      "mcpTemplate": "boot-web",
+      "mcp": {
+        "repository": "eGovFramework/egovframe-vscode-initializr",
+        "branch": "main",
+        "multiProject": false,
+        "archive": {
+          "kind": "initializr-zip",
+          "commit": "f8f572596e0c19d7992b132298992d5ce56ea819",
+          "path": "templates/projects/examples/egovframe-boot-web.zip",
+          "sha256": "1284019f991f0676683dc1b19e9133318e50f18092505e0c1635ef1336bd1f6c",
+          "bytes": 15551650
+        }
+      },
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
     },
     {
       "id": "egov-boot-simple-backend",
@@ -175,8 +198,20 @@
         "fileName": "egovframe-msa-portal-backend.zip",
         "pomFile": null
       },
-      "mcpTemplate": null,
-      "mcp": null
+      "mcpTemplate": "msa-portal-backend",
+      "mcp": {
+        "repository": "eGovFramework/egovframe-vscode-initializr",
+        "branch": "main",
+        "multiProject": true,
+        "archive": {
+          "kind": "initializr-zip",
+          "commit": "f8f572596e0c19d7992b132298992d5ce56ea819",
+          "path": "templates/projects/examples/egovframe-msa-portal-backend.zip",
+          "sha256": "dd8e7563c6eb981c4ad6641f68bf9473badccac10164f51c8357b217c64fdd1d",
+          "bytes": 1101491
+        }
+      },
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
     },
     {
       "id": "egov-msa-portal-frontend",
@@ -187,8 +222,20 @@
         "fileName": "egovframe-msa-portal-frontend.zip",
         "pomFile": null
       },
-      "mcpTemplate": null,
-      "mcp": null
+      "mcpTemplate": "msa-portal-frontend",
+      "mcp": {
+        "repository": "eGovFramework/egovframe-vscode-initializr",
+        "branch": "main",
+        "multiProject": true,
+        "archive": {
+          "kind": "initializr-zip",
+          "commit": "f8f572596e0c19d7992b132298992d5ce56ea819",
+          "path": "templates/projects/examples/egovframe-msa-portal-frontend.zip",
+          "sha256": "022b3615d7140f05361f09ce54024284b3be072a0f6f355ecd6738c71bb9e8e0",
+          "bytes": 6562922
+        }
+      },
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
     },
     {
       "id": "egov-mobile-web",
@@ -199,8 +246,20 @@
         "fileName": "egovframe-mobile-web.zip",
         "pomFile": "egovframe-mobile-web-pom.xml"
       },
-      "mcpTemplate": null,
-      "mcp": null
+      "mcpTemplate": "mobile-web",
+      "mcp": {
+        "repository": "eGovFramework/egovframe-vscode-initializr",
+        "branch": "main",
+        "multiProject": false,
+        "archive": {
+          "kind": "initializr-zip",
+          "commit": "f8f572596e0c19d7992b132298992d5ce56ea819",
+          "path": "templates/projects/examples/egovframe-mobile-web.zip",
+          "sha256": "b1ebcf172a775fada2418509a61b51914709eeb803ca6d03ef1bba766c9bc57b",
+          "bytes": 359099
+        }
+      },
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
     },
     {
       "id": "egov-mobile-common-components",
@@ -211,8 +270,20 @@
         "fileName": "egovframe-mobile-common-components.zip",
         "pomFile": "egovframe-mobile-common-components-pom.xml"
       },
-      "mcpTemplate": null,
-      "mcp": null
+      "mcpTemplate": "mobile-common-components",
+      "mcp": {
+        "repository": "eGovFramework/egovframe-vscode-initializr",
+        "branch": "main",
+        "multiProject": false,
+        "archive": {
+          "kind": "initializr-zip",
+          "commit": "f8f572596e0c19d7992b132298992d5ce56ea819",
+          "path": "templates/projects/examples/egovframe-mobile-common-components.zip",
+          "sha256": "0c0abe6922042e940221ea05f94868dac293ba4d2315d17fdc16d26ef23b42c0",
+          "bytes": 10696748
+        }
+      },
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
     },
     {
       "id": "egov-mobile-deviceapi",
@@ -239,8 +310,20 @@
         "fileName": "egovframe-boot-batch-file-scheduler.zip",
         "pomFile": "egovframe-boot-batch-file-scheduler-pom.xml"
       },
-      "mcpTemplate": null,
-      "mcp": null
+      "mcpTemplate": "batch-file-scheduler",
+      "mcp": {
+        "repository": "eGovFramework/egovframe-vscode-initializr",
+        "branch": "main",
+        "multiProject": false,
+        "archive": {
+          "kind": "initializr-zip",
+          "commit": "f8f572596e0c19d7992b132298992d5ce56ea819",
+          "path": "templates/projects/examples/egovframe-boot-batch-file-scheduler.zip",
+          "sha256": "407b09f3c678f8bd96c5da7aa38fe574622a1b507a676d3937c1a8cafafb95d1",
+          "bytes": 714016
+        }
+      },
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
     },
     {
       "id": "egov-boot-batch-commandline-file",
@@ -251,8 +334,20 @@
         "fileName": "egovframe-boot-batch-file-commandline.zip",
         "pomFile": "egovframe-boot-batch-file-commandline-pom.xml"
       },
-      "mcpTemplate": null,
-      "mcp": null
+      "mcpTemplate": "batch-file-commandline",
+      "mcp": {
+        "repository": "eGovFramework/egovframe-vscode-initializr",
+        "branch": "main",
+        "multiProject": false,
+        "archive": {
+          "kind": "initializr-zip",
+          "commit": "f8f572596e0c19d7992b132298992d5ce56ea819",
+          "path": "templates/projects/examples/egovframe-boot-batch-file-commandline.zip",
+          "sha256": "c51352a2b4ce41ed64f0a0f543c5319164dcc16ac32f853bac44f1ee166535cc",
+          "bytes": 713252
+        }
+      },
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
     },
     {
       "id": "egov-boot-batch-web-file",
@@ -263,8 +358,20 @@
         "fileName": "egovframe-boot-batch-file-web.zip",
         "pomFile": "egovframe-boot-batch-file-web-pom.xml"
       },
-      "mcpTemplate": null,
-      "mcp": null
+      "mcpTemplate": "batch-file-web",
+      "mcp": {
+        "repository": "eGovFramework/egovframe-vscode-initializr",
+        "branch": "main",
+        "multiProject": false,
+        "archive": {
+          "kind": "initializr-zip",
+          "commit": "f8f572596e0c19d7992b132298992d5ce56ea819",
+          "path": "templates/projects/examples/egovframe-boot-batch-file-web.zip",
+          "sha256": "15b75e445cfd9dd0162dbf23034937acb6cac4cd25af45cc162b55ef91a7a1c8",
+          "bytes": 1465409
+        }
+      },
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
     },
     {
       "id": "egov-boot-batch-scheduler-db",
@@ -275,8 +382,20 @@
         "fileName": "egovframe-boot-batch-db-scheduler.zip",
         "pomFile": "egovframe-boot-batch-db-scheduler-pom.xml"
       },
-      "mcpTemplate": null,
-      "mcp": null
+      "mcpTemplate": "batch-db-scheduler",
+      "mcp": {
+        "repository": "eGovFramework/egovframe-vscode-initializr",
+        "branch": "main",
+        "multiProject": false,
+        "archive": {
+          "kind": "initializr-zip",
+          "commit": "f8f572596e0c19d7992b132298992d5ce56ea819",
+          "path": "templates/projects/examples/egovframe-boot-batch-db-scheduler.zip",
+          "sha256": "b0cb160b252325eb6c29c93d978a5026913d377339e15c5551f615ca0cd2b7e7",
+          "bytes": 712628
+        }
+      },
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
     },
     {
       "id": "egov-boot-batch-commandline-db",
@@ -287,8 +406,20 @@
         "fileName": "egovframe-boot-batch-db-commandline.zip",
         "pomFile": "egovframe-boot-batch-db-commandline-pom.xml"
       },
-      "mcpTemplate": null,
-      "mcp": null
+      "mcpTemplate": "batch-db-commandline",
+      "mcp": {
+        "repository": "eGovFramework/egovframe-vscode-initializr",
+        "branch": "main",
+        "multiProject": false,
+        "archive": {
+          "kind": "initializr-zip",
+          "commit": "f8f572596e0c19d7992b132298992d5ce56ea819",
+          "path": "templates/projects/examples/egovframe-boot-batch-db-commandline.zip",
+          "sha256": "0de452a317f939f37867f66d293d8e6879fd868aa89c3ad1cc7a07c2b1c0ffd9",
+          "bytes": 1440218
+        }
+      },
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
     },
     {
       "id": "egov-boot-batch-web-db",
@@ -299,8 +430,20 @@
         "fileName": "egovframe-boot-batch-db-web.zip",
         "pomFile": "egovframe-boot-batch-db-web-pom.xml"
       },
-      "mcpTemplate": null,
-      "mcp": null
+      "mcpTemplate": "batch-db-web",
+      "mcp": {
+        "repository": "eGovFramework/egovframe-vscode-initializr",
+        "branch": "main",
+        "multiProject": false,
+        "archive": {
+          "kind": "initializr-zip",
+          "commit": "f8f572596e0c19d7992b132298992d5ce56ea819",
+          "path": "templates/projects/examples/egovframe-boot-batch-db-web.zip",
+          "sha256": "e229849102dee90fe7605107d9a4122425b67ddf2aa1bbc41b01af42bbc9e0c9",
+          "bytes": 1470738
+        }
+      },
+      "note": "단독 공식 저장소가 없어 Initializr 의 zip(Git LFS)을 commit·sha256 고정으로 조달한다"
     },
     {
       "id": "egov-ai-rag-springai",
@@ -343,7 +486,7 @@
       "repository": "eGovFramework/egovframe-web-sample",
       "branch": "main",
       "multiProject": false,
-      "note": "Initializr 의 egov-web 은 빈 골격이라 대응 항목으로 보지 않는다"
+      "note": "게시판 샘플 저장소. Initializr 의 egov-web(빈 골격)은 MCP 의 web 템플릿에 대응한다"
     },
     {
       "id": "msa-edu",

package/dist/index.js

@@ -24,7 +24,7 @@ import { fileURLToPath } from "node:url";
 import { buildServer } from "./server.js";
 // ── 공개 API — 모듈 분리 전과 동일한 표면을 유지한다 ──
 export { DOWNLOAD_TIMEOUT_MS, COMPONENTS_DOWNLOAD_TIMEOUT_MS } from "./shared.js";
-export { TEMPLATES, GLOBALS_PROPS_REL, DB_TYPES, customizePomCoordinates, createProject } from "./project.js";
+export { TEMPLATES, GLOBALS_PROPS_REL, DB_TYPES, INITIALIZR_REPO, INITIALIZR_COMMIT, archiveDownloadUrl, applyPomPlaceholders, isGlobalsPropertiesPath, customizePomCoordinates, createProject } from "./project.js";
 export { loadCatalog, resolveComponents, searchComponents } from "./catalog.js";
 export { MANIFEST_FILE, readManifest } from "./manifest.js";
 export { AI_STACKS, loadAiCatalog, planAiComponents, findProjectDependenciesClose, AI_POM_BACKUP, addAiComponents, stripAiPomAdditions } from "./ai.js";
@@ -43,7 +43,7 @@ export { ProjectFileTransaction, TransactionError, withDirectoryTransaction, wit
 export { ALLOWED_ROOTS_ENV, AllowedRootsError, assertPathAllowed, describeAllowedRoots, enforceAllowedRoots, loadAllowedRoots } from "./allowed-roots.js";
 export { detectBuildToolAt, resolveGoals, resolveCommand, parseBuildErrors, capOutput, defaultRunner, killProcessTree, KILL_GRACE_MS, runBuild } from "./build-runner.js";
 export { reportDirFor, resolveTestArgs, validateTestFilter, locateInStack, parseJUnitXml, snapshotReports, readJUnitReports, summarizeReports, runTests } from "./test-runner.js";
-export { loadTemplateCatalog, syncTemplateCatalog, diffProjects, normalizeInitializrProjects } from "./template-catalog.js";
+export { loadTemplateCatalog, syncTemplateCatalog, diffProjects, normalizeInitializrProjects, parseLfsPointer } from "./template-catalog.js";
 /**
  * 이 파일이 실행 진입점인지 판정한다.
  *

package/dist/project.js

@@ -3,7 +3,15 @@ import AdmZip from "adm-zip";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { withDirectoryTransaction } from "./file-transaction.js";
-import { DOWNLOAD_TIMEOUT_MS, fetchWithTimeout } from "./shared.js";
+import { createHash } from "node:crypto";
+import { COMPONENTS_DOWNLOAD_TIMEOUT_MS, DOWNLOAD_TIMEOUT_MS, fetchWithTimeout } from "./shared.js";
+export const INITIALIZR_REPO = "eGovFramework/egovframe-vscode-initializr";
+/** zip 지문을 조사한 Initializr commit (2026-09-18). 갱신 절차: docs/design-initializr-zip-templates.md */
+export const INITIALIZR_COMMIT = "f8f572596e0c19d7992b132298992d5ce56ea819";
+/** Git LFS 객체를 commit 기준으로 내려받는 URL. */
+export function archiveDownloadUrl(repo, ref, filePath) {
+    return `https://media.githubusercontent.com/media/${repo}/${ref}/${filePath}`;
+}
 /** 지원 템플릿 목록 (공식 eGovFramework 조직 저장소) */
 export const TEMPLATES = {
     "simple-backend": {
@@ -60,7 +68,176 @@ export const TEMPLATES = {
         description: "AI RAG 예제 (Spring AI · LangChain4j 2종 멀티 프로젝트, 좌표·DB 자동 적용 없음)",
         multiProject: true,
     },
+    // ── Initializr zip 조달 (v0.27.0) — 단독 저장소가 없는 공식 프로젝트 ──
+    "web": {
+        repo: INITIALIZR_REPO,
+        branch: "main",
+        description: "웹 프로젝트 빈 골격 (Spring MVC + JSP, 공통 설정만 포함 — 게시판 샘플이 필요하면 web-sample)",
+        archive: {
+            kind: "initializr-zip",
+            commit: INITIALIZR_COMMIT,
+            path: "templates/projects/examples/egovframe-web.zip",
+            sha256: "13674f6f76e74e6d70478b7e9ad0689b0f84b5ffc9828a49f8b511dc2b3d6b69",
+            bytes: 15547491,
+        },
+    },
+    "boot-web": {
+        repo: INITIALIZR_REPO,
+        branch: "main",
+        description: "Boot 웹 프로젝트 빈 골격 (Spring Boot 기반)",
+        archive: {
+            kind: "initializr-zip",
+            commit: INITIALIZR_COMMIT,
+            path: "templates/projects/examples/egovframe-boot-web.zip",
+            sha256: "1284019f991f0676683dc1b19e9133318e50f18092505e0c1635ef1336bd1f6c",
+            bytes: 15551650,
+        },
+    },
+    "batch-file-scheduler": {
+        repo: INITIALIZR_REPO,
+        branch: "main",
+        description: "Boot 배치 템플릿 — 파일(SAM) 기반, 스케줄러 실행",
+        archive: {
+            kind: "initializr-zip",
+            commit: INITIALIZR_COMMIT,
+            path: "templates/projects/examples/egovframe-boot-batch-file-scheduler.zip",
+            sha256: "407b09f3c678f8bd96c5da7aa38fe574622a1b507a676d3937c1a8cafafb95d1",
+            bytes: 714016,
+        },
+    },
+    "batch-file-commandline": {
+        repo: INITIALIZR_REPO,
+        branch: "main",
+        description: "Boot 배치 템플릿 — 파일(SAM) 기반, 커맨드라인 실행",
+        archive: {
+            kind: "initializr-zip",
+            commit: INITIALIZR_COMMIT,
+            path: "templates/projects/examples/egovframe-boot-batch-file-commandline.zip",
+            sha256: "c51352a2b4ce41ed64f0a0f543c5319164dcc16ac32f853bac44f1ee166535cc",
+            bytes: 713252,
+        },
+    },
+    "batch-file-web": {
+        repo: INITIALIZR_REPO,
+        branch: "main",
+        description: "Boot 배치 템플릿 — 파일(SAM) 기반, 웹 실행",
+        archive: {
+            kind: "initializr-zip",
+            commit: INITIALIZR_COMMIT,
+            path: "templates/projects/examples/egovframe-boot-batch-file-web.zip",
+            sha256: "15b75e445cfd9dd0162dbf23034937acb6cac4cd25af45cc162b55ef91a7a1c8",
+            bytes: 1465409,
+        },
+    },
+    "batch-db-scheduler": {
+        repo: INITIALIZR_REPO,
+        branch: "main",
+        description: "Boot 배치 템플릿 — DB 기반, 스케줄러 실행",
+        archive: {
+            kind: "initializr-zip",
+            commit: INITIALIZR_COMMIT,
+            path: "templates/projects/examples/egovframe-boot-batch-db-scheduler.zip",
+            sha256: "b0cb160b252325eb6c29c93d978a5026913d377339e15c5551f615ca0cd2b7e7",
+            bytes: 712628,
+        },
+    },
+    "batch-db-commandline": {
+        repo: INITIALIZR_REPO,
+        branch: "main",
+        description: "Boot 배치 템플릿 — DB 기반, 커맨드라인 실행",
+        archive: {
+            kind: "initializr-zip",
+            commit: INITIALIZR_COMMIT,
+            path: "templates/projects/examples/egovframe-boot-batch-db-commandline.zip",
+            sha256: "0de452a317f939f37867f66d293d8e6879fd868aa89c3ad1cc7a07c2b1c0ffd9",
+            bytes: 1440218,
+        },
+    },
+    "batch-db-web": {
+        repo: INITIALIZR_REPO,
+        branch: "main",
+        description: "Boot 배치 템플릿 — DB 기반, 웹 실행",
+        archive: {
+            kind: "initializr-zip",
+            commit: INITIALIZR_COMMIT,
+            path: "templates/projects/examples/egovframe-boot-batch-db-web.zip",
+            sha256: "e229849102dee90fe7605107d9a4122425b67ddf2aa1bbc41b01af42bbc9e0c9",
+            bytes: 1470738,
+        },
+    },
+    "mobile-web": {
+        repo: INITIALIZR_REPO,
+        branch: "main",
+        description: "모바일 웹 프로젝트 빈 골격",
+        archive: {
+            kind: "initializr-zip",
+            commit: INITIALIZR_COMMIT,
+            path: "templates/projects/examples/egovframe-mobile-web.zip",
+            sha256: "b1ebcf172a775fada2418509a61b51914709eeb803ca6d03ef1bba766c9bc57b",
+            bytes: 359099,
+        },
+    },
+    "mobile-common-components": {
+        repo: INITIALIZR_REPO,
+        branch: "main",
+        description: "모바일 공통컴포넌트 올인원 프로젝트",
+        archive: {
+            kind: "initializr-zip",
+            commit: INITIALIZR_COMMIT,
+            path: "templates/projects/examples/egovframe-mobile-common-components.zip",
+            sha256: "0c0abe6922042e940221ea05f94868dac293ba4d2315d17fdc16d26ef23b42c0",
+            bytes: 10696748,
+        },
+    },
+    "msa-portal-backend": {
+        repo: INITIALIZR_REPO,
+        branch: "main",
+        description: "MSA 포털 백엔드 (apigateway·config·discovery·서비스별 Gradle 멀티 프로젝트, 좌표·DB 자동 적용 없음)",
+        multiProject: true,
+        archive: {
+            kind: "initializr-zip",
+            commit: INITIALIZR_COMMIT,
+            path: "templates/projects/examples/egovframe-msa-portal-backend.zip",
+            sha256: "dd8e7563c6eb981c4ad6641f68bf9473badccac10164f51c8357b217c64fdd1d",
+            bytes: 1101491,
+        },
+    },
+    "msa-portal-frontend": {
+        repo: INITIALIZR_REPO,
+        branch: "main",
+        description: "MSA 포털 프론트엔드 (portal·admin 멀티 프로젝트, 좌표·DB 자동 적용 없음)",
+        multiProject: true,
+        archive: {
+            kind: "initializr-zip",
+            commit: INITIALIZR_COMMIT,
+            path: "templates/projects/examples/egovframe-msa-portal-frontend.zip",
+            sha256: "022b3615d7140f05361f09ce54024284b3be072a0f6f355ecd6738c71bb9e8e0",
+            bytes: 6562922,
+        },
+    },
 };
+/** Initializr zip 의 pom.xml 이 쓰는 자리표시자. */
+const POM_PLACEHOLDER_RE = /###(GROUP_ID|ARTIFACT_ID|NAME|VERSION|URL)###/g;
+/** Initializr 방식 pom 자리표시자(###GROUP_ID### 등)를 실제 값으로 바꾼다. 자리표시자가 없으면 원문 그대로. */
+export function applyPomPlaceholders(pom, groupId, projectName) {
+    const values = {
+        GROUP_ID: groupId,
+        ARTIFACT_ID: projectName,
+        NAME: projectName,
+        VERSION: "1.0.0",
+        URL: "https://www.egovframe.go.kr",
+    };
+    let replaced = 0;
+    const out = pom.replace(POM_PLACEHOLDER_RE, (_m, key) => {
+        replaced++;
+        return values[key];
+    });
+    return { pom: out, replaced };
+}
+/** zip 항목 중 DbType 설정을 가진 globals.properties 후보(템플릿마다 경로가 다르다). */
+export function isGlobalsPropertiesPath(relPath) {
+    return /^src\/main\/resources\/.+\/globals\.properties$/.test(relPath);
+}
 /** 레거시 템플릿의 DB 설정 파일 경로 */
 export const GLOBALS_PROPS_REL = "src/main/resources/egovframework/egovProps/globals.properties";
 /** 템플릿의 application.properties가 지원하는 DB 타입 */
@@ -117,17 +294,41 @@ export async function createProjectInternal(opts, transactionStagingPath) {
     const projectPath = path.resolve(opts.outputDir, opts.projectName);
     if (!dryRun && fs.existsSync(projectPath))
         throw new Error(`대상 디렉터리가 이미 존재합니다: ${projectPath}`);
-    // 1) 공식 템플릿 다운로드 (branch/tag/SHA 모두 허용)
-    const zipUrl = `https://codeload.github.com/${tpl.repo}/zip/${ref}`;
-    const res = await fetchWithTimeout(zipUrl, DOWNLOAD_TIMEOUT_MS);
+    // 1) 공식 템플릿 다운로드
+    //    - 저장소 템플릿: codeload 아카이브 (branch/tag/SHA 모두 허용)
+    //    - zip 조달 템플릿: 고정 commit 의 LFS 객체 + sha256·크기 검증 (ref 를 직접 주면 검증 생략)
+    const archive = tpl.archive;
+    const effectiveRef = archive ? (opts.ref ? ref : archive.commit) : ref;
+    const zipUrl = archive
+        ? archiveDownloadUrl(tpl.repo, effectiveRef, archive.path)
+        : `https://codeload.github.com/${tpl.repo}/zip/${ref}`;
+    const res = await fetchWithTimeout(zipUrl, archive ? COMPONENTS_DOWNLOAD_TIMEOUT_MS : DOWNLOAD_TIMEOUT_MS);
     if (!res.ok)
-        throw new Error(`템플릿 다운로드 실패 (${res.status}) — ref='${ref}'가 존재하는지 확인하세요: ${zipUrl}`);
+        throw new Error(`템플릿 다운로드 실패 (${res.status}) — ref='${effectiveRef}'가 존재하는지 확인하세요: ${zipUrl}`);
     const buf = Buffer.from(await res.arrayBuffer());
+    const customized = [];
+    let archiveVerified;
+    if (archive) {
+        if (opts.ref) {
+            archiveVerified = false;
+            customized.push(`⚠️ ref='${effectiveRef}' 지정 — 고정 지문(sha256) 검증을 건너뜁니다`);
+        }
+        else {
+            // shared.sha256() 은 매니페스트용 "sha256:" 접두 표기라, LFS oid 와 비교할 순수 hex 를 따로 계산한다.
+            const actual = createHash("sha256").update(buf).digest("hex");
+            if (buf.length !== archive.bytes || actual !== archive.sha256)
+                throw new Error(`템플릿 zip 지문이 고정값과 다릅니다 (${opts.template}) — 크기 ${buf.length}/${archive.bytes}, sha256 ${actual.slice(0, 12)}…/${archive.sha256.slice(0, 12)}…\n` +
+                    `upstream 이 바뀌었는지 sync_egovframe_templates 로 확인하세요: ${zipUrl}`);
+            archiveVerified = true;
+        }
+    }
     const zip = new AdmZip(buf);
     const entries = zip.getEntries();
-    const rootPrefix = entries[0].entryName.split("/")[0] + "/";
-    const rel = (name) => (name.startsWith(rootPrefix) ? name.slice(rootPrefix.length) : name);
-    const customized = [];
+    if (entries.length === 0)
+        throw new Error(`템플릿 zip 이 비어 있습니다: ${zipUrl}`);
+    // codeload 아카이브는 `<repo>-<ref>/` 최상위 폴더가 있지만, Initializr zip 은 프로젝트 루트가 곧 zip 루트다.
+    const rootPrefix = archive ? "" : entries[0].entryName.split("/")[0] + "/";
+    const rel = (name) => (rootPrefix && name.startsWith(rootPrefix) ? name.slice(rootPrefix.length) : name);
     // 2) 미리보기(dryRun): 쓰지 않고 수행 예정 내용만 계산
     if (dryRun) {
         const fileCount = entries.filter((e) => !e.isDirectory && rel(e.entryName)).length;
@@ -135,6 +336,11 @@ export async function createProjectInternal(opts, transactionStagingPath) {
         const hasProps = entries.some((e) => rel(e.entryName) === "src/main/resources/application.properties");
         const hasPkg = entries.some((e) => rel(e.entryName) === "package.json");
         const hasGlobals = entries.some((e) => rel(e.entryName) === GLOBALS_PROPS_REL);
+        const extraGlobals = archive
+            ? entries.map((e) => rel(e.entryName)).filter((r) => r !== GLOBALS_PROPS_REL && isGlobalsPropertiesPath(r))
+            : [];
+        if (archive && archiveVerified)
+            customized.push(`zip 지문 검증 통과 (sha256 ${archive.sha256.slice(0, 12)}…, ${archive.bytes} bytes)`);
         if (tpl.multiProject) {
             customized.push("멀티 프로젝트 템플릿 — 좌표/DB 설정 자동 적용 없음 (하위 프로젝트별 README 참조)");
         }
@@ -145,6 +351,8 @@ export async function createProjectInternal(opts, transactionStagingPath) {
                 customized.push(`src/main/resources/application.properties (Globals.DbType=${opts.database}) — 적용 예정`);
             if (hasGlobals)
                 customized.push(`${GLOBALS_PROPS_REL} (Globals.DbType=${opts.database}) — 적용 예정`);
+            for (const g of extraGlobals)
+                customized.push(`${g} (Globals.DbType=${opts.database}) — 파일에 설정이 있으면 적용 예정`);
             if (hasPkg)
                 customized.push(`package.json (name=${opts.projectName}) — 적용 예정`);
         }
@@ -152,8 +360,9 @@ export async function createProjectInternal(opts, transactionStagingPath) {
             projectPath,
             filesExtracted: fileCount,
             customized,
-            ref,
+            ref: effectiveRef,
             dryRun: true,
+            archiveVerified,
             nextSteps: [`미리보기 모드입니다. 실제 생성하려면 dryRun 없이 다시 호출하세요.`],
         };
     }
@@ -180,7 +389,9 @@ export async function createProjectInternal(opts, transactionStagingPath) {
         const pomPath = path.join(stagingPath, "pom.xml");
         if (!tpl.multiProject && fs.existsSync(pomPath)) {
             let pom = fs.readFileSync(pomPath, "utf-8");
-            pom = customizePomCoordinates(pom, opts.groupId, opts.projectName);
+            // Initializr zip 은 좌표가 ###GROUP_ID### 같은 자리표시자다 — 먼저 채운 뒤 공통 좌표 적용을 거친다.
+            const filled = applyPomPlaceholders(pom, opts.groupId, opts.projectName);
+            pom = customizePomCoordinates(filled.pom, opts.groupId, opts.projectName);
             fs.writeFileSync(pomPath, pom);
             customized.push(`pom.xml (groupId=${opts.groupId}, artifactId/name=${opts.projectName})`);
         }
@@ -204,6 +415,24 @@ export async function createProjectInternal(opts, transactionStagingPath) {
                 customized.push(`${GLOBALS_PROPS_REL} (Globals.DbType=${opts.database})`);
             }
         }
+        // 5c) zip 조달 템플릿: globals.properties 위치가 템플릿마다 다르다(batch/properties 등)
+        if (archive && !tpl.multiProject) {
+            for (const e of entries) {
+                if (e.isDirectory)
+                    continue;
+                const r = rel(e.entryName);
+                if (r === GLOBALS_PROPS_REL || !isGlobalsPropertiesPath(r))
+                    continue;
+                const target = path.join(stagingPath, r);
+                if (!target.startsWith(stagingPath + path.sep) || !fs.existsSync(target))
+                    continue;
+                const props = fs.readFileSync(target, "utf-8");
+                if (!/^Globals\.DbType\s*=.*$/m.test(props))
+                    continue;
+                fs.writeFileSync(target, props.replace(/^Globals\.DbType\s*=.*$/m, `Globals.DbType = ${opts.database}`));
+                customized.push(`${r} (Globals.DbType=${opts.database})`);
+            }
+        }
         // 6) package.json: 프론트엔드 템플릿의 프로젝트명 적용
         const pkgPath = path.join(stagingPath, "package.json");
         if (!tpl.multiProject && fs.existsSync(pkgPath)) {
@@ -237,19 +466,23 @@ export async function createProjectInternal(opts, transactionStagingPath) {
     else {
         count = await withDirectoryTransaction(path.resolve(opts.outputDir), opts.projectName, "프로젝트 생성", populate);
     }
+    if (archive && archiveVerified)
+        customized.unshift(`zip 지문 검증 통과 (sha256 ${archive.sha256.slice(0, 12)}…, ${archive.bytes} bytes)`);
     const buildStep = tpl.multiProject
         ? "README.md 참조 — backend/frontend/k8s/docker-compose 하위 프로젝트별 기동 안내"
         : opts.template === "simple-react"
             ? "npm install && npm start"
-            : opts.template === "simple-backend"
-                ? "mvn -B verify   # 빌드/테스트 (JDK 17, hsql 외 DB는 접속정보를 application-*.properties에 설정)"
-                : "mvn -B package   # WAR 빌드 (DB 초기화는 DATABASE/ 또는 README의 스크립트 참조)";
+            : archive
+                ? "mvn -B package   # 빌드 (실행 방식·DB 준비는 프로젝트의 readme·DATABASE/·설정 파일 참조)"
+                : opts.template === "simple-backend"
+                    ? "mvn -B verify   # 빌드/테스트 (JDK 17, hsql 외 DB는 접속정보를 application-*.properties에 설정)"
+                    : "mvn -B package   # WAR 빌드 (DB 초기화는 DATABASE/ 또는 README의 스크립트 참조)";
     const nextSteps = [
         `cd ${projectPath}`,
         buildStep,
         "자바 패키지 구조 변경(groupId에 맞춘 소스 이동)은 PoC 범위 밖입니다 — IDE의 rename refactoring 사용을 권장합니다.",
     ];
-    return { projectPath, filesExtracted: count, customized, nextSteps, ref, dryRun: false };
+    return { projectPath, filesExtracted: count, customized, nextSteps, ref: effectiveRef, dryRun: false, archiveVerified };
 }
 /** 템플릿 zip 다운로드 → 압축 해제 → 사용자 값 적용 (dryRun이면 미리보기만) */
 export async function createProject(opts) {

package/dist/server.js

@@ -127,6 +127,10 @@ export function buildServer() {
             ...(result.uncovered.length > 0
                 ? [`- 미커버 목록: ${result.uncovered.map((project) => `${project.id}(${project.category})`).join(", ")}`]
                 : []),
+            `- zip 조달 템플릿 지문: ${result.archivesChecked}종 대조, 차이 ${result.archiveDrift.length}건`,
+            ...result.archiveDrift.map((d) => d.error
+                ? `  - ${d.template}: 확인 실패 (${d.error})`
+                : `  - ${d.template}: sha256 ${d.pinnedSha256.slice(0, 12)}… → ${d.upstreamSha256} (${d.pinnedBytes} → ${d.upstreamBytes} bytes)`),
             ...result.warnings.map((warning) => `- 경고: ${warning}`),
         ].join("\n");
         return { content: [{ type: "text", text }] };

package/dist/template-catalog.js

@@ -59,6 +59,16 @@ export function diffProjects(pinned, upstream) {
     }
     return drift.sort((a, b) => a.id.localeCompare(b.id));
 }
+/** Git LFS 포인터 본문에서 oid·size 를 읽는다. 포인터가 아니면 null. */
+export function parseLfsPointer(text) {
+    if (!/^version https:\/\/git-lfs\.github\.com\/spec\/v1\s*$/m.test(text))
+        return null;
+    const oid = /^oid sha256:([0-9a-f]{64})\s*$/m.exec(text);
+    const size = /^size (\d+)\s*$/m.exec(text);
+    if (!oid || !size)
+        return null;
+    return { sha256: oid[1], bytes: Number(size[1]) };
+}
 async function fetchTextWithTimeout(url, timeoutMs) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), timeoutMs);
@@ -113,18 +123,44 @@ export async function syncTemplateCatalog(options = {}, deps = {}) {
     const uncovered = catalog.projects
         .filter((p) => !p.mcpTemplate)
         .map((p) => ({ id: p.id, category: p.category, displayName: p.displayName }));
+    // zip 조달 템플릿: raw 호스트가 돌려주는 LFS 포인터(작은 텍스트)만 읽어 고정 지문과 대조한다(zip 본문은 받지 않는다).
+    const pins = new Map();
+    for (const p of catalog.projects) {
+        if (p.mcpTemplate && p.mcp?.archive)
+            pins.set(p.mcpTemplate, { template: p.mcpTemplate, repository: p.mcp.repository, pin: p.mcp.archive });
+    }
+    const archiveDrift = [];
+    await Promise.all([...pins.values()].map(async ({ template, repository, pin }) => {
+        const pointerUrl = `https://raw.githubusercontent.com/${repository}/${ref}/${pin.path}`;
+        const base = { template, path: pin.path, pinnedSha256: pin.sha256, pinnedBytes: pin.bytes };
+        try {
+            const pointer = parseLfsPointer(await fetchText(pointerUrl, TEMPLATE_CATALOG_TIMEOUT_MS));
+            if (!pointer)
+                archiveDrift.push({ ...base, upstreamSha256: null, upstreamBytes: null, error: "LFS 포인터 형식이 아닙니다" });
+            else if (pointer.sha256 !== pin.sha256 || pointer.bytes !== pin.bytes)
+                archiveDrift.push({ ...base, upstreamSha256: pointer.sha256, upstreamBytes: pointer.bytes });
+        }
+        catch (error) {
+            archiveDrift.push({ ...base, upstreamSha256: null, upstreamBytes: null, error: error.message });
+        }
+    }));
+    archiveDrift.sort((a, b) => a.template.localeCompare(b.template));
+    if (archiveDrift.length > 0)
+        warnings.push("zip 조달 템플릿의 upstream 지문이 고정값과 다릅니다 — 고정 commit 의 zip 은 계속 받을 수 있으므로 생성은 동작합니다. 새 zip 을 검토한 뒤 src/project.ts 의 INITIALIZR_COMMIT·sha256·bytes 를 갱신하세요");
     return {
         repository: source.repository,
         path: source.path,
         requestedRef: ref,
         pinnedSha256: source.sha256,
         upstreamSha256,
-        upToDate: drift.length === 0 && source.sha256 === upstreamSha256,
+        upToDate: drift.length === 0 && source.sha256 === upstreamSha256 && archiveDrift.length === 0,
         pinnedProjects: catalog.projects.length,
         upstreamProjects: upstream.length,
         drift,
         coverage: catalog.coverage,
         uncovered,
+        archivesChecked: pins.size,
+        archiveDrift,
         warnings,
     };
 }

package/docs/design-initializr-zip-templates.md

@@ -0,0 +1,50 @@
+# Initializr zip 조달 템플릿 설계 (v0.27.0)
+
+## 배경
+
+v0.26.0의 통합 카탈로그(`catalog/templates.json`)는 공식 프로젝트 22종 가운데 MCP가 9종만 다룬다는 것을 계산값으로 보여 주었습니다. 남은 13종 가운데 12종은 단독 GitHub 저장소가 없고, eGovFrame VSCode Initializr 저장소 안에 zip으로만 배포됩니다.
+
+- 위치: `eGovFramework/egovframe-vscode-initializr` 의 `templates/projects/examples/*.zip`
+- 저장 방식: Git LFS. 저장소에는 `oid sha256:…`·`size …` 를 담은 포인터만 있고, 본문은 `media.githubusercontent.com` 에서 받습니다.
+- 구조: zip 루트가 곧 프로젝트 루트입니다(codeload 아카이브와 달리 `<repo>-<ref>/` 최상위 폴더가 없음).
+- 좌표: `pom.xml` 의 groupId·artifactId·name·version·url 이 `###GROUP_ID###` 같은 자리표시자입니다. Initializr 는 같은 내용의 pom 템플릿으로 덮어쓰는데, zip 안의 `pom.xml` 과 그 템플릿이 동일함을 확인했으므로 MCP 는 zip 의 `pom.xml` 에서 자리표시자만 채웁니다.
+
+## 결정
+
+| 항목 | 결정 | 이유 |
+|---|---|---|
+| 조달 단위 | `TEMPLATES` 항목에 선택 필드 `archive` 추가 | 기존 10종(저장소 조달)의 동작과 타입을 그대로 둔다 |
+| 고정 방식 | Initializr **commit** + LFS 포인터의 **sha256·bytes** | 브랜치는 움직인다. commit 으로 URL 을 고정하고 바이트까지 검증해 조사 시점과 같은 산출물임을 보장한다(공통컴포넌트 카탈로그의 v5.0.6 고정과 같은 원칙) |
+| 검증 실패 | 아무 파일도 쓰지 않고 거부 | 검증은 압축 해제·transaction 시작 전에 끝난다 |
+| `ref` 직접 지정 | 허용하되 지문 검증을 건너뛰고 결과에 `archiveVerified: false` 와 경고를 남긴다 | 최신 zip 을 시험해 볼 길은 열어 두되, 검증되지 않았음을 숨기지 않는다 |
+| 멀티 프로젝트 | `msa-portal-backend`·`msa-portal-frontend` 는 `multiProject: true` | 하위 모듈 좌표를 건드리지 않는 기존 규칙과 동일 |
+| DbType | `src/main/resources/**/globals.properties` 중 `Globals.DbType` 줄이 있는 파일에 적용 | 배치 템플릿은 `egovframework/batch/properties/`, 웹 템플릿은 `egovframework/egovProps/` 로 경로가 다르다 |
+| 제외 | `egov-template-common-components`(23MB 올인원) | MCP 는 공통컴포넌트를 `add_egovframe_components` 로 선택 조립한다는 기존 큐레이션 결정을 유지 |
+
+추가된 템플릿 id: `web`, `boot-web`, `batch-file-scheduler`, `batch-file-commandline`, `batch-file-web`, `batch-db-scheduler`, `batch-db-commandline`, `batch-db-web`, `mobile-web`, `mobile-common-components`, `msa-portal-backend`, `msa-portal-frontend`. 커버리지는 22종 중 9 → 21종입니다.
+
+## upstream 변화 감지
+
+`sync_egovframe_templates` 가 zip 본문을 받지 않고 **LFS 포인터(약 130바이트)** 만 `raw.githubusercontent.com` 에서 읽어 고정 지문과 대조합니다.
+
+- 결과 필드: `archivesChecked`, `archiveDrift[]`(template·path·pinned/upstream sha256·bytes·error)
+- 지문이 달라져도 **생성은 계속 동작**합니다. 다운로드 URL 이 고정 commit 을 가리키기 때문입니다. drift 는 "새 zip 이 나왔으니 검토하라"는 신호입니다.
+- 포인터 하나를 읽지 못해도 동기화 전체가 실패하지 않고 항목별 `error` 로 보고합니다.
+
+## 고정값 갱신 절차
+
+1. `sync_egovframe_templates()` 를 실행해 `archiveDrift` 에 나온 템플릿과 upstream sha256·bytes 를 확인합니다.
+2. 새 zip 을 검토합니다(구조 변화, 자리표시자, `globals.properties` 경로).
+3. `src/project.ts` 의 `INITIALIZR_COMMIT` 을 새 commit 으로, 해당 항목의 `sha256`·`bytes` 를 포인터 값으로 바꿉니다. commit 은 전 항목이 공유하므로, 바뀌지 않은 zip 의 지문은 그대로 두면 됩니다(같은 객체).
+4. `npm run build && npm run generate:template-catalog` 로 `catalog/templates.json` 을 다시 만듭니다.
+5. `npm run test:pom && npm run test:template-catalog && npm run test:templates` 로 확인합니다.
+
+## 필요한 네트워크
+
+기존 `codeload.github.com`·`raw.githubusercontent.com` 에 더해 zip 본문을 받는 `media.githubusercontent.com` 이 필요합니다.
+
+## 검증
+
+- 오프라인: 자리표시자 치환(5개·비자리표시자 `######` 보존·parent 보존), globals 경로 판별, URL 구성, 12종 정의 유효성(`npm run test:pom`), LFS 포인터 해석·지문 drift·포인터 오류 보고(`npm run test:template-catalog`)
+- 네트워크: `batch-file-commandline` 실생성(지문 검증·좌표·DbType·zip 루트 보존), 지문 불일치 거부와 무기록, `ref` 지정 시 검증 생략 표시, `msa-portal-backend` dryRun(`npm run test:templates`)
+- 수동: 12종 전부 실생성해 자리표시자 0건 확인, `batch-db-commandline`·`boot-web`·`mobile-web` 은 `mvn compile` 통과

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "egovframe-scaffold-mcp",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "전자정부 표준프레임워크(eGovFrame) 프로젝트·CRUD 스캐폴딩과 검증된 공통컴포넌트 완전 조립 MCP 서버",
   "license": "Apache-2.0",
   "type": "module",