projectops 4.2.17 → 4.2.19

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.
Files changed (4) hide show
  1. package/README.md +1 -1
  2. package/package.json +1 -1
  3. package/src/core/migration-guide.js +16 -16
  4. package/src/ui/summary.js +5 -3
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
  > 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.
8
8
 
9
9
  <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
10
- ## 최신 버전 : v4.2.16 (2026-07-14)
10
+ ## 최신 버전 : v4.2.18 (2026-07-14)
11
11
 
12
12
  [전체 버전 기록 보기](CHANGELOG.md)
13
13
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "projectops",
3
- "version": "4.2.17",
3
+ "version": "4.2.19",
4
4
  "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI",
5
5
  "keywords": [
6
6
  "devops",
package/src/core/migration-guide.js CHANGED
@@ -19,12 +19,12 @@ const HEADER = `# ProjectOps 마이그레이션 가이드
19
19
  ## 사람이 읽는 법
20
20
 
21
21
  - 각 엔트리의 **확인 체크리스트**가 그 실행 이후 사람이 마무리해야 하는 수동 작업입니다.
22
- - 체크리스트는 실행에서 실제 발생한 것만 나옵니다 — 항목이 없으면 할 일이 없다는 뜻입니다.
23
- - 상세 실행 기록(파일별 결정·치환 전후값)은 엔트리 메타의 \`trace_file\`(JSONL)·\`log_file\`(터미널 원문)에 있습니다.
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\` | 파일별 결정·치환 전후값 JSONL (Layer 2) | "왜 이 파일이 이렇게 됐나"는 파일명으로 grep |
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 || ""} — v${from} → v${to} (${r.mode || "full"})`);
96
+ L.push(`## ${r.now || ""} - v${from} → v${to} (${r.mode || "full"})`);
97
97
  L.push("");
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)}개`);
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}개 — 신형과 병합 검토**: ${wf.skippedConflict.map((f) => `\`${f}\``).join(", ")}`);
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(`- [ ] **적용된 배포 환경값 검증** — 실제 환경과 다르면 워크플로우 env를 직접 수정:`);
120
+ checklist.push(`- [ ] **적용된 배포 환경값 검증** (실제 환경과 다르면 워크플로우 env를 직접 수정):`);
121
121
  for (const [t, kv] of envByType) {
122
- for (const [k, v] of kv) checklist.push(` - ${t} · \`${k}\` = \`${v}\``);
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"}\` 생성 — 릴리스 PR이 동작하려면 필요합니다`);
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} — ${it.title || ""}`);
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
@@ -128,10 +128,12 @@ export function printSummary(ctx, targetRoot = ".") {
128
128
 
129
129
  err(" 📖 TEMPLATE REPO: https://github.com/Cassiiopeia/projectops");
130
130
  err(" 📚 워크플로우 가이드: .github/workflows/project-types/README.md");
131
- // #493 — 이번 실행의 마이그레이션 기록 (수동 체크리스트·breaking 조치·AI 메타데이터)
131
+ // #493 — 이번 실행의 마이그레이션 기록. "뭐가 남았고 AI에게 어떻게 시키는지"가 바로 보이게 행동 유도형으로 안내.
132
132
  if (ctx?.migrationGuidePath) {
133
133
  err(` 🧭 마이그레이션 가이드: ${ctx.migrationGuidePath}`);
134
- err(" (이번 실행의 변경 내역·수동 확인 체크리스트·AI Agent용 메타데이터가 기록됐습니다)");
134
+ err(" 이번 설치에서 바뀐 내용과 직접 확인해야 할 작업이 이 파일에 정리되어 있습니다.");
135
+ err(" 💡 AI Agent(Claude, Cursor 등)에게 \"마이그레이션 가이드 확인하고");
136
+ err(" 남은 작업 처리해줘\"라고 요청하면 이 문서를 읽고 대신 진행합니다.");
135
137
  }
136
138
  err("");
137
139
 
@@ -147,7 +149,7 @@ export function printSummary(ctx, targetRoot = ".") {
147
149
  err("");
148
150
  // #490 — 마법사가 브랜치를 직접 생성(또는 존재 확인)했으면 같은 작업을 재지시하지 않는다
149
151
  if (deployBranchReady) {
150
- err(` 2️⃣ ✅ ${deployBranchName} 브랜치 준비 완료 — 마법사가 확인·생성했습니다 (추가 작업 불필요)`);
152
+ err(` 2️⃣ ✅ ${deployBranchName} 브랜치 준비 완료: 마법사가 확인 및 생성했습니다 (추가 작업 불필요)`);
151
153
  } else {
152
154
  err(` 2️⃣ ${deployBranchName} 브랜치 생성 (아직 없다면)`);
153
155
  err(` → git checkout -b ${deployBranchName} && git push -u origin ${deployBranchName}`);