projectops 4.2.17 → 4.2.18
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/package.json +1 -1
- package/src/core/migration-guide.js +16 -16
- package/src/ui/summary.js +2 -2
package/README.md
CHANGED
package/package.json
CHANGED
|
@@ -19,12 +19,12 @@ const HEADER = `# ProjectOps 마이그레이션 가이드
|
|
|
19
19
|
## 사람이 읽는 법
|
|
20
20
|
|
|
21
21
|
- 각 엔트리의 **확인 체크리스트**가 그 실행 이후 사람이 마무리해야 하는 수동 작업입니다.
|
|
22
|
-
- 체크리스트는 실행에서 실제 발생한 것만
|
|
23
|
-
- 상세 실행 기록(파일별
|
|
22
|
+
- 체크리스트는 실행에서 실제 발생한 것만 나옵니다. 항목이 없으면 할 일이 없다는 뜻입니다.
|
|
23
|
+
- 상세 실행 기록(파일별 결정과 치환 전후값)은 엔트리 메타의 \`trace_file\`(JSONL)과 \`log_file\`(터미널 원문)에 있습니다.
|
|
24
24
|
|
|
25
25
|
## AI Agent 해석 가이드라인
|
|
26
26
|
|
|
27
|
-
각 엔트리의 \`\`\`yaml 메타 블록(\`# projectops-migration\`)을 파싱해 아래 규칙으로
|
|
27
|
+
각 엔트리의 \`\`\`yaml 메타 블록(\`# projectops-migration\`)을 파싱해 아래 규칙으로 판단하고 조치한다.
|
|
28
28
|
|
|
29
29
|
| 필드 | 의미 | 권장 조치 |
|
|
30
30
|
|------|------|----------|
|
|
@@ -34,8 +34,8 @@ const HEADER = `# ProjectOps 마이그레이션 가이드
|
|
|
34
34
|
| \`env_applied\` | 워크플로우에 적용된 환경값 | 실제 워크플로우 env와 대조 → 드리프트 발견 시 경고 |
|
|
35
35
|
| \`breaking_traversed\` | 이 실행이 통과한 호환성 변경 (조치 방법 전문은 사람용 섹션) | \`action_required: true\` 항목의 조치 완료 여부 확인 |
|
|
36
36
|
| \`manual_actions_pending\` | 남은 수동 작업 코드 목록 | 비어 있지 않으면 사용자에게 상기 |
|
|
37
|
-
| \`trace_file\` | 파일별
|
|
38
|
-
| \`log_file\` | 터미널 출력 원문 (Layer 3) | 실행
|
|
37
|
+
| \`trace_file\` | 파일별 결정과 치환 전후값 JSONL (Layer 2) | "왜 이 파일이 이렇게 됐나"는 파일명으로 grep |
|
|
38
|
+
| \`log_file\` | 터미널 출력 원문 (Layer 3) | 실행 재현, 포렌식 디버깅용 |
|
|
39
39
|
|
|
40
40
|
- 스키마는 \`schema\` 필드로 버저닝된다. 모르는 필드는 무시하고, 아는 필드만 사용한다.
|
|
41
41
|
- 여러 엔트리가 있으면 **가장 최근 엔트리**가 현재 상태의 기준이다. 과거 엔트리는 이력 참고용.
|
|
@@ -93,39 +93,39 @@ export function renderGuideEntry(report) {
|
|
|
93
93
|
const L = [];
|
|
94
94
|
L.push("---");
|
|
95
95
|
L.push("");
|
|
96
|
-
L.push(`## ${r.now || ""}
|
|
96
|
+
L.push(`## ${r.now || ""} - v${from} → v${to} (${r.mode || "full"})`);
|
|
97
97
|
L.push("");
|
|
98
|
-
L.push(`- 타입: ${(r.types ?? []).join(", ") || "-"}
|
|
99
|
-
L.push(`- 워크플로우: 신규/갱신 ${wf.added.length + wf.replacedBak.length}
|
|
98
|
+
L.push(`- 타입: ${(r.types ?? []).join(", ") || "-"} / 배포: ${r.options?.deploy ?? "-"} / publish: ${(r.options?.publish ?? []).join(",") || "없음"}`);
|
|
99
|
+
L.push(`- 워크플로우: 신규/갱신 ${wf.added.length + wf.replacedBak.length}개, 유지(unchanged/충돌스킵) ${(r.counters?.skipped ?? 0)}개`);
|
|
100
100
|
L.push("");
|
|
101
101
|
|
|
102
102
|
// ── 확인 체크리스트 (동적 — 실제 발생분만) ──
|
|
103
103
|
const checklist = [];
|
|
104
104
|
if (leftoverOldGen.length) {
|
|
105
|
-
checklist.push(`- [ ] **구세대 배포 워크플로우 ${leftoverOldGen.length}개 전환 후 삭제**
|
|
105
|
+
checklist.push(`- [ ] **구세대 배포 워크플로우 ${leftoverOldGen.length}개 전환 후 삭제** (현역 배포일 수 있어 마법사가 건드리지 않았습니다):`);
|
|
106
106
|
for (const o of leftoverOldGen) checklist.push(` - \`${o.file}\`${o.replacement ? ` → 신형 \`${o.replacement}\`` : ""}`);
|
|
107
107
|
}
|
|
108
108
|
if (wf.replacedBak.length || legacyNeutralized.length) {
|
|
109
|
-
checklist.push(`- [ ] **.bak 백업 파일 확인 후 정리**
|
|
109
|
+
checklist.push(`- [ ] **.bak 백업 파일 확인 후 정리** (커스텀 유실분이 없는지 신형과 비교하세요):`);
|
|
110
110
|
for (const f of wf.replacedBak) checklist.push(` - \`${f}.bak\` (충돌 교체 백업)`);
|
|
111
111
|
for (const a of legacyNeutralized) if (a.to && String(a.to).endsWith(".bak")) checklist.push(` - \`${a.to}\` (레거시 무해화)`);
|
|
112
112
|
}
|
|
113
113
|
if (wf.skippedConflict.length) {
|
|
114
|
-
checklist.push(`- [ ] **기존 수정본 유지 ${wf.skippedConflict.length}
|
|
114
|
+
checklist.push(`- [ ] **기존 수정본 유지 ${wf.skippedConflict.length}개, 신형과 병합 검토**: ${wf.skippedConflict.map((f) => `\`${f}\``).join(", ")}`);
|
|
115
115
|
}
|
|
116
116
|
if (wf.added.length || wf.replacedBak.length) {
|
|
117
117
|
checklist.push(`- [ ] **새/갱신 CICD가 요구하는 GitHub Secrets 등록 확인** (Settings → Secrets → Actions, \`_GITHUB_PAT_TOKEN\` 포함)`);
|
|
118
118
|
}
|
|
119
119
|
if (envByType.size) {
|
|
120
|
-
checklist.push(`- [ ] **적용된 배포 환경값 검증**
|
|
120
|
+
checklist.push(`- [ ] **적용된 배포 환경값 검증** (실제 환경과 다르면 워크플로우 env를 직접 수정):`);
|
|
121
121
|
for (const [t, kv] of envByType) {
|
|
122
|
-
for (const [k, v] of kv) checklist.push(` - ${t}
|
|
122
|
+
for (const [k, v] of kv) checklist.push(` - ${t} \`${k}\` = \`${v}\``);
|
|
123
123
|
}
|
|
124
124
|
}
|
|
125
125
|
if (r.branches?.created === true) {
|
|
126
|
-
checklist.push(`- [x] 개발(릴리스 소스) 브랜치 \`${r.branches?.deployBranch ?? "develop"}
|
|
126
|
+
checklist.push(`- [x] 개발(릴리스 소스) 브랜치 \`${r.branches?.deployBranch ?? "develop"}\`: 마법사가 생성 및 확인 완료`);
|
|
127
127
|
} else if (r.branches?.ready === false) {
|
|
128
|
-
checklist.push(`- [ ] 개발(릴리스 소스) 브랜치 \`${r.branches?.deployBranch ?? "develop"}\` 생성
|
|
128
|
+
checklist.push(`- [ ] 개발(릴리스 소스) 브랜치 \`${r.branches?.deployBranch ?? "develop"}\` 생성 (릴리스 PR이 동작하려면 필요합니다)`);
|
|
129
129
|
}
|
|
130
130
|
if (checklist.length) {
|
|
131
131
|
L.push("### 확인 체크리스트");
|
|
@@ -140,7 +140,7 @@ export function renderGuideEntry(report) {
|
|
|
140
140
|
L.push("");
|
|
141
141
|
for (const it of breakingAll) {
|
|
142
142
|
const sev = (breaking.critical ?? []).includes(it) ? "CRITICAL" : "WARNING";
|
|
143
|
-
L.push(`#### ${sev === "CRITICAL" ? "❗" : "⚠️"} [${sev}] ${it.version}
|
|
143
|
+
L.push(`#### ${sev === "CRITICAL" ? "❗" : "⚠️"} [${sev}] ${it.version} - ${it.title || ""}`);
|
|
144
144
|
if (it.message) L.push(`${it.message}`);
|
|
145
145
|
L.push("");
|
|
146
146
|
}
|
package/src/ui/summary.js
CHANGED
|
@@ -131,7 +131,7 @@ export function printSummary(ctx, targetRoot = ".") {
|
|
|
131
131
|
// #493 — 이번 실행의 마이그레이션 기록 (수동 체크리스트·breaking 조치·AI 메타데이터)
|
|
132
132
|
if (ctx?.migrationGuidePath) {
|
|
133
133
|
err(` 🧭 마이그레이션 가이드: ${ctx.migrationGuidePath}`);
|
|
134
|
-
err(" (이번 실행의 변경
|
|
134
|
+
err(" (이번 실행의 변경 내역, 수동 확인 체크리스트, AI Agent용 메타데이터가 기록됐습니다)");
|
|
135
135
|
}
|
|
136
136
|
err("");
|
|
137
137
|
|
|
@@ -147,7 +147,7 @@ export function printSummary(ctx, targetRoot = ".") {
|
|
|
147
147
|
err("");
|
|
148
148
|
// #490 — 마법사가 브랜치를 직접 생성(또는 존재 확인)했으면 같은 작업을 재지시하지 않는다
|
|
149
149
|
if (deployBranchReady) {
|
|
150
|
-
err(` 2️⃣ ✅ ${deployBranchName} 브랜치 준비
|
|
150
|
+
err(` 2️⃣ ✅ ${deployBranchName} 브랜치 준비 완료: 마법사가 확인 및 생성했습니다 (추가 작업 불필요)`);
|
|
151
151
|
} else {
|
|
152
152
|
err(` 2️⃣ ${deployBranchName} 브랜치 생성 (아직 없다면)`);
|
|
153
153
|
err(` → git checkout -b ${deployBranchName} && git push -u origin ${deployBranchName}`);
|