dsh-ci-diet 0.2.0 → 0.4.0

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 (194) hide show
  1. package/README.es.md +191 -0
  2. package/README.fr.md +191 -0
  3. package/README.hi.md +191 -0
  4. package/README.ko.md +122 -124
  5. package/README.md +120 -127
  6. package/README.zh-Hans.md +191 -0
  7. package/client/index.d.ts +3 -0
  8. package/client/index.js +2324 -0
  9. package/cordis.patch.yml +3 -2
  10. package/dist/adapters/github/budget.d.ts +1 -1
  11. package/dist/adapters/github/budget.js +4 -2
  12. package/dist/adapters/github/budget.js.map +1 -1
  13. package/dist/adapters/github/client.d.ts +3 -0
  14. package/dist/adapters/github/client.js +30 -19
  15. package/dist/adapters/github/client.js.map +1 -1
  16. package/dist/adapters/github/endpoints.js +1 -0
  17. package/dist/adapters/github/endpoints.js.map +1 -1
  18. package/dist/adapters/github/errors.d.ts +1 -1
  19. package/dist/adapters/github/errors.js +5 -3
  20. package/dist/adapters/github/errors.js.map +1 -1
  21. package/dist/adapters/github/run-observation.d.ts +7 -0
  22. package/dist/adapters/github/run-observation.js +66 -0
  23. package/dist/adapters/github/run-observation.js.map +1 -0
  24. package/dist/adapters/github/transport.d.ts +12 -3
  25. package/dist/adapters/github/transport.js +145 -27
  26. package/dist/adapters/github/transport.js.map +1 -1
  27. package/dist/cli/compare.d.ts +4 -0
  28. package/dist/cli/compare.js +84 -0
  29. package/dist/cli/compare.js.map +1 -0
  30. package/dist/cli/index.d.ts +25 -0
  31. package/dist/cli/index.js +348 -239
  32. package/dist/cli/index.js.map +1 -1
  33. package/dist/core/analysis/coverage.js +2 -2
  34. package/dist/core/analysis/coverage.js.map +1 -1
  35. package/dist/core/analysis/report-id.d.ts +3 -0
  36. package/dist/core/analysis/report-id.js +7 -0
  37. package/dist/core/analysis/report-id.js.map +1 -0
  38. package/dist/core/analysis/report.js +5 -6
  39. package/dist/core/analysis/report.js.map +1 -1
  40. package/dist/core/analysis/run-comparison.d.ts +50 -0
  41. package/dist/core/analysis/run-comparison.js +64 -0
  42. package/dist/core/analysis/run-comparison.js.map +1 -0
  43. package/dist/core/config/load.d.ts +13 -0
  44. package/dist/core/config/load.js +71 -0
  45. package/dist/core/config/load.js.map +1 -0
  46. package/dist/core/config/plugin-settings.d.ts +39 -0
  47. package/dist/core/config/plugin-settings.js +79 -0
  48. package/dist/core/config/plugin-settings.js.map +1 -0
  49. package/dist/core/contracts/schema-json.generated.d.ts +1 -1
  50. package/dist/core/contracts/schema-json.generated.js +1 -1
  51. package/dist/core/contracts/schema-json.generated.js.map +1 -1
  52. package/dist/core/contracts/schema.d.ts +7 -7
  53. package/dist/core/data/contracts.generated.d.ts +2 -2
  54. package/dist/core/data/contracts.generated.js +2 -2
  55. package/dist/core/data/contracts.generated.js.map +1 -1
  56. package/dist/core/history/model.d.ts +1 -1
  57. package/dist/core/history/model.js +20 -21
  58. package/dist/core/history/model.js.map +1 -1
  59. package/dist/core/history/storage.d.ts +17 -0
  60. package/dist/core/history/storage.js +81 -0
  61. package/dist/core/history/storage.js.map +1 -0
  62. package/dist/core/history/sync.d.ts +8 -3
  63. package/dist/core/history/sync.js +226 -44
  64. package/dist/core/history/sync.js.map +1 -1
  65. package/dist/core/model/domain.d.ts +1 -1
  66. package/dist/core/model/domain.js +1 -1
  67. package/dist/core/model/domain.js.map +1 -1
  68. package/dist/core/patch/apply.d.ts +28 -7
  69. package/dist/core/patch/apply.js +393 -289
  70. package/dist/core/patch/apply.js.map +1 -1
  71. package/dist/core/patch/approval.d.ts +5 -0
  72. package/dist/core/patch/approval.js +26 -1
  73. package/dist/core/patch/approval.js.map +1 -1
  74. package/dist/core/patch/attestation.js +7 -3
  75. package/dist/core/patch/attestation.js.map +1 -1
  76. package/dist/core/patch/dependencies.d.ts +1 -0
  77. package/dist/core/patch/dependencies.js +386 -143
  78. package/dist/core/patch/dependencies.js.map +1 -1
  79. package/dist/core/patch/diff.d.ts +11 -0
  80. package/dist/core/patch/diff.js +81 -0
  81. package/dist/core/patch/diff.js.map +1 -0
  82. package/dist/core/patch/edits.d.ts +3 -1
  83. package/dist/core/patch/edits.js +51 -4
  84. package/dist/core/patch/edits.js.map +1 -1
  85. package/dist/core/patch/eligibility.d.ts +4 -3
  86. package/dist/core/patch/eligibility.js +24 -20
  87. package/dist/core/patch/eligibility.js.map +1 -1
  88. package/dist/core/patch/locks.d.ts +56 -0
  89. package/dist/core/patch/locks.js +217 -0
  90. package/dist/core/patch/locks.js.map +1 -0
  91. package/dist/core/patch/plan.d.ts +1 -2
  92. package/dist/core/patch/plan.js +2 -2
  93. package/dist/core/patch/plan.js.map +1 -1
  94. package/dist/core/patch/request-plan.d.ts +51 -0
  95. package/dist/core/patch/request-plan.js +133 -0
  96. package/dist/core/patch/request-plan.js.map +1 -0
  97. package/dist/core/patch/semantic.d.ts +1 -1
  98. package/dist/core/patch/semantic.js +53 -16
  99. package/dist/core/patch/semantic.js.map +1 -1
  100. package/dist/core/patch/store.d.ts +124 -6
  101. package/dist/core/patch/store.js +788 -112
  102. package/dist/core/patch/store.js.map +1 -1
  103. package/dist/core/patch/target.js +8 -0
  104. package/dist/core/patch/target.js.map +1 -1
  105. package/dist/core/patch/verify.d.ts +4 -3
  106. package/dist/core/patch/verify.js +18 -6
  107. package/dist/core/patch/verify.js.map +1 -1
  108. package/dist/core/policy/constants.d.ts +34 -0
  109. package/dist/core/policy/constants.js +35 -0
  110. package/dist/core/policy/constants.js.map +1 -0
  111. package/dist/core/report/run-comparison.d.ts +4 -0
  112. package/dist/core/report/run-comparison.js +28 -0
  113. package/dist/core/report/run-comparison.js.map +1 -0
  114. package/dist/core/rules/cd001.js +120 -42
  115. package/dist/core/rules/cd001.js.map +1 -1
  116. package/dist/core/rules/cd003.js +42 -14
  117. package/dist/core/rules/cd003.js.map +1 -1
  118. package/dist/core/rules/cd005.d.ts +0 -5
  119. package/dist/core/rules/cd005.js +174 -69
  120. package/dist/core/rules/cd005.js.map +1 -1
  121. package/dist/core/rules/cd006.d.ts +3 -0
  122. package/dist/core/rules/cd006.js +31 -0
  123. package/dist/core/rules/cd006.js.map +1 -0
  124. package/dist/core/rules/cd008.d.ts +1 -2
  125. package/dist/core/rules/cd008.js +2 -2
  126. package/dist/core/rules/cd008.js.map +1 -1
  127. package/dist/core/rules/index.js +3 -2
  128. package/dist/core/rules/index.js.map +1 -1
  129. package/dist/core/rules/npm-cache.d.ts +12 -0
  130. package/dist/core/rules/npm-cache.js +65 -0
  131. package/dist/core/rules/npm-cache.js.map +1 -0
  132. package/dist/core/rules/types.d.ts +1 -0
  133. package/dist/core/rules/types.js.map +1 -1
  134. package/dist/core/savings/report-metrics.js +5 -1
  135. package/dist/core/savings/report-metrics.js.map +1 -1
  136. package/dist/core/scan/binding.d.ts +34 -2
  137. package/dist/core/scan/binding.js +58 -17
  138. package/dist/core/scan/binding.js.map +1 -1
  139. package/dist/core/scan/discover.d.ts +2 -0
  140. package/dist/core/scan/discover.js +11 -8
  141. package/dist/core/scan/discover.js.map +1 -1
  142. package/dist/core/scan/scan.d.ts +4 -0
  143. package/dist/core/scan/scan.js +12 -9
  144. package/dist/core/scan/scan.js.map +1 -1
  145. package/dist/core/support/clock.d.ts +34 -0
  146. package/dist/core/support/clock.js +34 -0
  147. package/dist/core/support/clock.js.map +1 -0
  148. package/dist/core/support/concurrency.d.ts +11 -0
  149. package/dist/core/support/concurrency.js +47 -0
  150. package/dist/core/support/concurrency.js.map +1 -0
  151. package/dist/core/support/deadline.d.ts +17 -0
  152. package/dist/core/support/deadline.js +45 -0
  153. package/dist/core/support/deadline.js.map +1 -0
  154. package/dist/core/support/filesystem.d.ts +19 -0
  155. package/dist/core/support/filesystem.js +8 -0
  156. package/dist/core/support/filesystem.js.map +1 -0
  157. package/dist/core/version.d.ts +1 -1
  158. package/dist/core/version.js +1 -1
  159. package/dist/core/workflow/byte-ranges.d.ts +5 -0
  160. package/dist/core/workflow/byte-ranges.js +34 -0
  161. package/dist/core/workflow/byte-ranges.js.map +1 -0
  162. package/dist/core/workflow/jobkey.js +85 -37
  163. package/dist/core/workflow/jobkey.js.map +1 -1
  164. package/dist/core/workflow/matrix.d.ts +4 -2
  165. package/dist/core/workflow/matrix.js +121 -27
  166. package/dist/core/workflow/matrix.js.map +1 -1
  167. package/dist/core/workflow/parse.js +46 -40
  168. package/dist/core/workflow/parse.js.map +1 -1
  169. package/dist/dsh/host/defaults-migration.d.ts +6 -0
  170. package/dist/dsh/host/defaults-migration.js +42 -0
  171. package/dist/dsh/host/defaults-migration.js.map +1 -0
  172. package/dist/dsh/host/plugin.d.ts +133 -6
  173. package/dist/dsh/host/plugin.js +245 -149
  174. package/dist/dsh/host/plugin.js.map +1 -1
  175. package/dist/dsh/host/preflight.d.ts +24 -0
  176. package/dist/dsh/host/preflight.js +192 -0
  177. package/dist/dsh/host/preflight.js.map +1 -0
  178. package/dist/dsh/host/review.d.ts +105 -0
  179. package/dist/dsh/host/review.js +197 -0
  180. package/dist/dsh/host/review.js.map +1 -0
  181. package/dist/shared/i18n/en.d.ts +23 -8
  182. package/dist/shared/i18n/en.js +23 -8
  183. package/dist/shared/i18n/en.js.map +1 -1
  184. package/dist/shared/i18n/es.js +23 -8
  185. package/dist/shared/i18n/es.js.map +1 -1
  186. package/dist/shared/i18n/fr.js +23 -8
  187. package/dist/shared/i18n/fr.js.map +1 -1
  188. package/dist/shared/i18n/hi.js +23 -8
  189. package/dist/shared/i18n/hi.js.map +1 -1
  190. package/dist/shared/i18n/ko.js +23 -8
  191. package/dist/shared/i18n/ko.js.map +1 -1
  192. package/dist/shared/i18n/zh-Hans.js +23 -8
  193. package/dist/shared/i18n/zh-Hans.js.map +1 -1
  194. package/package.json +15 -3
package/README.ko.md CHANGED
@@ -1,135 +1,145 @@
1
1
  # CI Diet
2
2
 
3
- 낭비된 GitHub Actions 러너 시간을 찾고, 작고 검토 가능한 패치를 제안합니다.
3
+ [English](README.md) · [한국어](README.ko.md) · [简体中文](README.zh-Hans.md) · [हिन्दी](README.hi.md) · [Español](README.es.md) · [Français](README.fr.md)
4
4
 
5
- 상태: **알파, npm에 `dsh-ci-diet@0.2.0`로 배포됨**. 계약, 명세, 분석 엔진,
6
- 패치 엔진, CLI, DSH 플러그인 도구, 자체 완결형 HTML 보고서는 구현과 테스트를
7
- 마쳤습니다. DSH Web 클라이언트 화면은 아직 남아 있습니다.
5
+ **상태:** 알파. `dsh-ci-diet@0.4.0`이 npm에 게시되어 있습니다. 현재 소스 트리에는 기존 계약, 분석·패치 엔진, CLI, DSH 도구, 설정 화면, 자체 완결형 HTML 보고서와 함께 **설정 → CI Diet Reports** 검토 화면이 추가되어 있습니다. 검토 화면은 앞선 커밋에서 실제 브라우저 E2E를 통과했습니다. 1회 기본값 마이그레이션은 DSH `0.2.1-rc.2`의 configEditor, SettingsForms, Loader 런타임에서 별도로 검증했으며 새 브라우저 화면 렌더를 확인한 것은 아닙니다. 이제 DSH 플러그인은 preflight, 이력용 네트워크 접근, 로컬 적용이 기본으로 켜진 상태에서 시작합니다.
8
6
 
9
- ## 하는 일
7
+ **DSH 기본값과 마이그레이션.** 새 DSH 프로필은 `preflightEnabled`, `networkEnabled`, `localApplyEnabled`가 `true`이고 CD001, CD002, CD004, CD006, CD008이 켜진 상태로 시작합니다. 기존 프로필을 처음 시작할 때 CI Diet는 DSH `configEditor`의 잠금 편집으로 세 스위치를 저장하고 위 규칙을 기존 선택에 더한 뒤 그 프로필에 `defaultsRevision: 1`을 기록합니다. 상태 경로, 보관 기간, 쿼터, 과금 입력과 기존에 명시적으로 켠 CD003 또는 CD005는 그대로 둡니다. 저장 뒤에 끈 스위치나 제외한 규칙은 재시작과 업데이트를 거쳐도 유지합니다. CD003과 CD005는 켜지 않는 한 꺼져 있고, 과금 추정은 기본 꺼짐이며 명시적으로 켜야 합니다. 기존에 켜 둔 과금 설정은 유지합니다.
8
+
9
+ CI Diet는 낭비 가능성이 있는 GitHub Actions 작업을 찾고, 각 발견의 근거를 보존하며, 사람이 검토할 작은 workflow 수정을 미리 보여줍니다.
10
10
 
11
- CI Diet는 두 가지를 읽고 비교합니다.
11
+ **설치만으로는 러너 시간이 줄지 않습니다.** 지원하는 DSH 배포 명령은 실행 전에 절감 후보를 자동으로 점검합니다. workflow 변경은 검토와 승인을 거친 뒤에만 적용합니다. DSH 플러그인에는 승인·적용·되돌리기 도구가 없고, preflight 자체도 파일을 바꾸지 않습니다. 설정 화면은 도구 설정을 저장하고 호스트의 세션별 보고서와 계획을 보여줄 뿐 workflow를 최적화하지 않습니다. 승인된 로컬 쓰기는 기본으로 켜져 있지만 적용에는 별도의 digest 승인이 필요합니다. 어떤 발견도 비용 절감을 보장하지 않습니다.
12
12
 
13
- 1. 현재 작업 폴더의 workflow YAML
14
- 2. 선택 사항으로, 읽기 전용 `gh api` 호출로 가져온 실행 이력
13
+ `preflightEnabled`는 기본 `true`입니다. `workdir` 인자가 있는 지원 대상 stateless DSH bash tool에서 literal `git push`, `npm|pnpm|bun publish`, `wrangler deploy`, `npm|pnpm|bun run deploy` 직전에 오프라인 점검을 합니다. npm CD006, PR 전용 workflow의 concurrency 누락, 명시적 다운로드 캐시 없는 Bun frozen install을 검토용으로 알립니다. 후보가 있으면 첫 명령은 실행하지 않고, 모델이 항목을 검토한 뒤 같은 명령을 다시 실행하면 허용합니다. preflight 자체는 네트워크 요청이나 파일 자동 변경을 하지 않고 plan 적용에는 여전히 사람의 승인이 필요합니다. persistent shell과 복잡한 shell wrapper는 판별하지 못해 건너뜁니다. 실제 절감량은 측정 전이므로 절감을 주장하지 않습니다.
15
14
 
16
- 여기서 러너 시간이 어디에 쓰였는지, 어떤 발견이 안전한 YAML 편집으로 바뀔 수
17
- 있는지 보고합니다. 모든 발견에는 근거 수준(`observed`, `inferred`, `static`)과
18
- 규칙별 coverage 상태가 붙습니다.
15
+ ## 하는 일
19
16
 
20
- | 규칙 | 찾는 것 | v0.1 패치 |
17
+ 정적 스캔은 대상 체크아웃의 workflow YAML을 읽습니다. 선택적인 이력 동기화는 읽기 전용 `gh api` 호출로 최근 실행을 모읍니다. 발견에는 근거 수준(`observed`, `inferred`, `static`)과 축별 수집 coverage가 붙습니다.
18
+
19
+ | 규칙 | 찾는 것 | 가능한 plan |
21
20
  | --- | --- | --- |
22
- | CD001 | 더 새 커밋에 밀린 PR 실행 | 패치: `concurrency` |
21
+ | CD001 | 더 새 커밋 때문에 무효가 된 PR 실행 | `concurrency` 편집 |
23
22
  | CD002 | 겹치는 트리거 | 설명만 |
24
- | CD003 | 문서만 바뀐 변경의 무거운 검사 | 설명만 |
23
+ | CD003 | 문서만 바뀐 변경의 무거운 검사 | 설명만, 기본 꺼짐 |
25
24
  | CD004 | 과대한 매트릭스 | 설명만 |
26
- | CD005 | `timeout-minutes` 없는 job | 패치: `timeout-minutes` |
27
- | CD008 | 긴 artifact 보존 기간 | 패치: `retention-days` |
28
-
29
- 규칙 집합은 일부러 작습니다. 실제 저장소에서 품질 기준을 통과한 규칙만
30
- 출시합니다. 잘못 짚는 규칙은 없는 규칙보다 나쁘기 때문입니다. CD003과 CD005는
31
- 구현되어 있지만 그 기준을 통과할 때까지 기본으로 꺼져 있습니다(ADR-13 참고).
25
+ | CD005 | `timeout-minutes`가 없는 job | timeout 편집, 기본 꺼짐 |
26
+ | CD006 | npm 캐시 없이 `npm ci`를 실행하는 `actions/setup-node@v3` 또는 `@v4` job | setup-node 입력 두 개, 기본 켜짐 |
27
+ | CD008 | 긴 artifact 보존 기간 | 보존 기간 편집 |
32
28
 
33
- ## 하지 않는 일
29
+ CD001은 겹쳐서 대체된 PR 실행에 도움을 줍니다. CD005는 비정상 실행의 상한을 두는 규칙이며 정상 job 실행 시간 자체를 줄이지 않습니다. CD008은 artifact 저장 보존 기간을 바꾸며 러너 분과는 관계가 없습니다. CD003과 CD005는 품질 기준을 통과할 때까지 기본으로 꺼져 있습니다. CD006은 좁은 npm 형태를 위한 기본 정적 규칙입니다. setup-node 다운로드 캐시를 켜고 `npm ci`와 모든 테스트는 그대로 실행합니다. 캐시가 데워지면 다운로드가 줄 수 있지만, cold와 warm 실행을 비교하기 전에는 시간이나 금액 절감을 주장하지 않습니다.
34
30
 
35
- - 커밋, 푸시, PR, 병합을 하지 않습니다.
36
- - workflow를 실행하지 않고, 실행 중인 job을 취소하지 않으며, artifact나 캐시를
37
- 삭제하지 않습니다.
38
- - 브랜치 보호 설정을 바꾸지 않습니다.
39
- - GitHub 쓰기 권한이 필요 없습니다. 이력 조회는 읽기 전용이고, 네트워크가 없어도
40
- 정적 스캔은 동작합니다.
41
- - job이 낭비인지 LLM으로 판정하지 않습니다.
42
- - 패치는 이미 가진 YAML의 바이트 범위 편집입니다. diff를 검토하고 직접 승인한 뒤
43
- 작업 폴더에 적용합니다.
31
+ ## 설치와 업그레이드
44
32
 
45
- ## 숫자를 섞지 않습니다
33
+ CLI에는 Node `^22.19.0 || >=24.0.0`이 필요합니다. 플러그인은 DSH `>=0.2.1-rc.2 <0.3.0-0` 및 `>=0.2.2-rc.1 <0.3.0-0`을 지원합니다. `0.3.1`은 DSH `0.2.1-rc.2`에서 검증했고 DSH `0.3.0`은 지원하지 않습니다.
46
34
 
47
- 비용 출력은 네 값을 분리해 표시합니다.
35
+ ```
36
+ npm install --global dsh-ci-diet@0.4.0
37
+ ci-diet --version
38
+ ```
48
39
 
49
- | 필드 | 의미 |
50
- | --- | --- |
51
- | `observedRunnerSeconds` | 실행 기록이 실제로 말하는 값 |
52
- | `modeledRoundedMinutes` | 과금처럼 분 단위로 올림한 값 |
53
- | `listPriceUsd` | 스냅샷 정가로 환산한 값 |
54
- | `actualBilledUsd` | 증명할 수 없으므로 항상 `null` |
40
+ 전역 설치를 원하지 않으면 `ci-diet` 명령 이름 자리에 `npx dsh-ci-diet@0.4.0`을 넣습니다. 예를 들어 `npx dsh-ci-diet@0.4.0 report --cwd .`처럼 실행합니다.
55
41
 
56
- 모든 보고서는 사용한 가격 스냅샷을 해시와 함께 포함하므로 나중에 같은 숫자를
57
- 재현할 수 있습니다. 스냅샷을 검증할 수 없으면 보고서를 내보내지 않습니다.
42
+ ```
43
+ dsh plugin --profile web add dsh-ci-diet@0.4.0
44
+ dsh --profile web
45
+ ```
58
46
 
59
- ## 설치
47
+ 설치하면 플러그인 도구, 설정 화면, **설정 → CI Diet Reports** 검토 화면이 등록됩니다. 플러그인의 preflight, 네트워크 접근, 로컬 적용은 기본으로 켜져 있습니다. 설치와 시작은 `gh`를 호출하거나 이력을 수집하거나 스캔을 실행하거나 workflow를 수정하지 않습니다.
60
48
 
61
49
  ```
62
- npm install --global dsh-ci-diet
63
- dsh plugin --profile web add dsh-ci-diet
50
+ npm install --global dsh-ci-diet@latest
51
+ dsh plugin --profile web add dsh-ci-diet@latest
64
52
  ```
65
53
 
66
- 플러그인은 기본으로 꺼진 로더 항목 하나를 추가합니다. 이력 동기화를 쓸 때만
67
- `networkEnabled`를 켜십시오. 전역 설치는 선택 사항입니다. `npx dsh-ci-diet`로
68
- 같은 CLI를 실행할 수 있고, DSH 플러그인은 프로필에 패키지가 있으면 됩니다.
69
- 릴리스 태그는 GitHub에, 같은 버전은 npm `0.2.0`에 있습니다.
54
+ 플러그인을 업데이트한 뒤 DSH를 재시작합니다. `dsh plugin --profile web list`, `ci-diet --version`, `npx dsh-ci-diet@latest --version`으로 설치 버전을 확인합니다.
55
+
56
+ ## 첫 스캔과 이력 보고서
70
57
 
71
- ## 실행
58
+ 검사할 저장소에서 명령을 실행합니다. `--cwd .`는 그 저장소를 뜻하고, `--cwd`에는 다른 경로도 줄 수 있습니다. 상대 경로는 적용된 작업 디렉터리 기준으로 해석됩니다. 첫 명령은 오프라인입니다. 이력 수집은 별도로 명시적으로 네트워크를 허용해야 합니다.
72
59
 
73
60
  ```
74
- ci-diet scan --cwd . # 네트워크 없는 정적 스캔
75
- ci-diet sync --network # 이 체크아웃의 GitHub Actions 이력 조회
76
- ci-diet plan --rule CD001 --workflow .github/workflows/ci.yml \
77
- --claims ci-only,replace-safe
78
- ci-diet approve --plan <planId> --confirm <digest tail>
79
- ci-diet apply --plan <planId> # 계획된 바이트 범위만 다시 씀
80
- ci-diet revert --change <changeId> # 백업한 바이트를 복원
61
+ ci-diet scan --cwd .
62
+ gh auth status
63
+ ci-diet sync --cwd . --network
64
+ ci-diet report --cwd .
65
+ ci-diet report --cwd . --format html --out report.html
81
66
  ```
82
67
 
83
- `plan`은 발견이 패치 가능하지 않거나, coverage가 쓰기를 허용하지 않거나, 해당
84
- 규칙이 의존하는 정책 스냅샷이 오래됐으면 계획을 만들지 않습니다. CD005는
85
- `--job`과 `--minutes`가, CD008은 `--job`과 `--step`, 그리고
86
- `--claims artifact-purpose:temporary,consumer-min-days:7`이 필요합니다. 명시적
87
- `approve` 없이는 아무것도 커밋·푸시·적용되지 않습니다.
68
+ `scan`은 네트워크 없이 정적 보고서를 출력합니다. `--json`이나 `--out FILE`로 그 출력을 쓸 수 있지만 CLI scan은 상태 저장소에 보고서를 저장하지 않습니다. `report`에는 CLI `sync`, 플러그인의 `ci_diet_scan` 또는 `ci_diet_sync`가 저장한 보고서가 필요합니다. 아래 CLI 전용 순서에서는 sync가 보고서를 저장한 뒤 HTML 옵션으로 외부 요청이 없는 파일 하나를 만듭니다. 이력 동기화에는 `gh`가 설치·인증되어 있고 저장소의 Actions 실행과 job을 읽을 권한이 있어야 합니다. `sync --network`는 CLI의 명시적 네트워크 허용입니다. GitHub 쓰기 권한은 필요하지 않습니다. 이력이 일부만 수집돼도 보고서를 만들고 저장하며 coverage가 불완전하다고 표시합니다. 플러그인의 오프라인 `ci_diet_scan`은 보고서를 저장하므로 바로 `ci_diet_report`를 실행할 수 있습니다.
69
+
70
+ DSH 플러그인의 네트워크 접근은 기본으로 켜져 있으므로 `gh`가 설치·인증되어 있으면 `ci_diet_sync`를 바로 실행할 수 있습니다. 이 스위치는 해당 도구가 `gh`를 호출하도록 허용할 뿐이며 설치·시작·설정 저장만으로 이력을 수집하지 않습니다. 플러그인의 네트워크 사용을 막으려면 **설정 → CI Diet**에서 **네트워크 접근 허용**을 끄고 **변경 저장**을 누릅니다. 이 설정은 플러그인 도구에 적용되며 CLI의 `--network` 플래그를 켜지는 않습니다. 정적 스캔과 보고서는 네트워크 없이 동작합니다. 설정 화면 자체가 최적화를 실행하지는 않습니다.
71
+
72
+ 좋은 채팅 요청에는 실행 순서와 검토 경계를 분명히 적습니다. 절대 경로 예시는 자신의 저장소 경로로 바꿉니다.
73
+
74
+ > `C:\work\my-repo`를 cwd로 `ci_diet_scan`을 실행하고, 같은 cwd로 `ci_diet_sync`, 이어서 `ci_diet_report`를 실행해 줘. `gh` 인증이 없거나 내가 네트워크 접근을 끄면 스캔 뒤 멈춰 줘. `ci_diet_plan`으로 패치를 미리 볼 때는 편집 내용만 보여 줘. 승인, 적용, 되돌리기, 커밋, 푸시, 배포는 하지 마.
88
75
 
89
- ## 보고서 읽기
76
+ 플러그인 미리보기는 plan을 저장하지 않습니다. 응답의 `nextCommand`는 plan을 CLI로 다시 만들어 같은 상태 저장소에 보관하고 사람의 승인 단계로 넘깁니다.
77
+
78
+ ## 오프라인 npm 캐시 plan (CD006)
79
+
80
+ CD006은 실행 이력이 필요 없습니다. 저장소 루트 job에서 `actions/checkout`에 사용자 `with` 옵션이 없고, 바로 뒤에 캐시를 쓰지 않는 `actions/setup-node@v3` 또는 `@v4` 단계가 하나 있으며, 그다음 단계의 `run`이 정확히 `npm ci`일 때 찾습니다. 루트의 `package.json`과 `package-lock.json`은 커밋된 일반 JSON 파일이어야 합니다. plan은 setup-node에 `cache: npm`과 `cache-dependency-path: package-lock.json`만 넣습니다. Node, action 버전, `npm ci`, 테스트, 로컬 캐시는 바꾸지 않습니다.
90
81
 
91
82
  ```
92
- ci-diet report # 저장된 최신 보고서의 텍스트 요약
93
- ci-diet report --format html --out report.html
94
- ci-diet diagnose # Job 이름 매칭과 수집 커버리지 설명
95
- ci-diet prune # 만료된 보고서, 계획, 캐시 정리
83
+ ci-diet plan --cwd . --rule CD006 --workflow .github/workflows/ci.yml --job test --step 1
84
+ ci-diet plans --cwd . --plan PLAN_ID
96
85
  ```
97
86
 
98
- HTML 파일은 자체 완결형입니다. 인라인 CSS만 쓰고 스크립트와 외부 요청이 없습니다.
99
- 읽기 전용이므로 승인은 digest와 nonce 검사가 있는 CLI에 남습니다.
87
+ `--step`은 setup-node 단계의 0부터 시작하는 인덱스입니다. 예시는 checkout이 0, setup-node가 1인 경우입니다. CLI `plan`은 이 정적 스캔을 메모리에서 실행하고 `sync` 없이 plan을 저장하며, 최신 저장 보고서는 그대로 둡니다. 플러그인 `ci_diet_plan`은 저장된 보고서가 필요하므로 먼저 `ci_diet_scan`을 실행합니다. 승인과 적용은 아래 기존 명령을 그대로 씁니다. plan과 attestation은 계획 단계에서 저장되고, workflow 파일은 사람이 plan을 승인하고 apply를 실행하기 전에는 바뀌지 않습니다.
100
88
 
101
- `diagnose`는 저장된 최신 이력을 읽어 GitHub Job 이름이 워크플로 키로 얼마나
102
- 해석됐는지, 어떤 matrix Job이 몇 개 레그로 확장됐는지, 어느 수집 상한 때문에
103
- 커버리지 축이 불완전한지 보여줍니다. 오프라인에서도 동작하며 `--require-complete`를
104
- 쓰면 축이 불완전할 때 종료 코드 `3`으로 끝납니다.
89
+ ## CLI 명령 참고
105
90
 
106
- 점검용 캐시 힌트도 함께 보여줍니다. 캐시 없이 의존성을 설치하는 Job이나
107
- lockfile 변경을 따라가지 못하는 리터럴 캐시 키가 대상입니다. 동결된 계약에는
108
- 캐시 규칙 ID가 없으므로 힌트는 발견 항목이나 패치로 이어지지 않습니다.
91
+ ```
92
+ ci-diet scan --cwd .
93
+ ci-diet sync --cwd . --network
94
+ ci-diet sync --cwd . --network --repo OWNER/REPO --days 7
95
+ ci-diet report --cwd .
96
+ ci-diet report --cwd . --format json
97
+ ci-diet report --cwd . --format html --out report.html
98
+ ci-diet diagnose --cwd .
99
+ ci-diet prune
100
+ ci-diet changes --cwd .
101
+ ci-diet plans --cwd . --plan PLAN_ID
102
+ ci-diet report --cwd . --lang ko
103
+ ```
109
104
 
105
+ `scan`은 workflow 파일을 검사합니다. `sync`는 `--network`가 있을 때만 이력을 읽으며, `--repo`로 `OWNER/REPO`를 직접 고르고 `--days`로 설정 범위 안에서 조회 기간을 조정합니다. `report`는 텍스트, JSON, HTML을 출력하고 `--out`은 `--cwd` 기준 상대 경로에 씁니다. `diagnose`는 저장된 이력으로 job 이름 매칭과 coverage를 설명하며, `--require-complete`를 붙이면 데이터가 불완전할 때 종료 코드 `3`으로 끝납니다. `prune`은 상태 저장소 설정에 따라 만료된 보고서, plan, 캐시 항목을 지웁니다. `changes`는 적용한 변경을, `plans`는 저장된 plan을 다시 보여줍니다. `--config FILE`은 모든 명령에 부분 JSON 설정을 병합합니다.
110
106
 
111
- ## 릴리스
107
+ ## 검토, 승인, 적용, 되돌리기
112
108
 
113
- `package.json`의 버전과 일치하는 태그를 푸시하면
114
- `.github/workflows/publish.yml`이 실행됩니다.
109
+ 성공한 CLI `plan`은 제안 diff, `p_...` 같은 실제 plan id, plan digest 마지막 12자를 이용한 confirmation을 보여줍니다. plan 생성 단계에서는 오래된 근거와 안전하지 않은 쓰기를 거부하며, workflow가 없으면 사용법 오류와 종료 코드 `1`로 끝날 수 있습니다. 저장한 plan을 보는 `plans --plan` 실행 시 작업 공간이나 workflow가 사라졌으면 diff를 숨기고 plan JSON은 보존한 채 다시 plan을 만들라고 안내하며 종료 코드 `3`으로 끝납니다. workflow 바이트가 저장된 원본 해시와 달라도 같습니다. 승인 전에 diff와 plan을 다시 확인합니다.
115
110
 
116
111
  ```
117
- git tag v0.2.0
118
- git push origin v0.2.0
112
+ ci-diet plan --cwd . --rule CD001 --workflow .github/workflows/ci.yml --claims ci-only,replace-safe
113
+ ci-diet plans --cwd . --plan PLAN_ID
114
+ ci-diet approve --cwd . --plan PLAN_ID --confirm CONFIRMATION
115
+ ci-diet apply --cwd . --plan PLAN_ID
116
+ ci-diet revert --cwd . --change CHANGE_ID
119
117
  ```
120
118
 
121
- 워크플로는 태그와 `package.json` 버전을 대조하고(`node
122
- scripts/check-release-tag.mjs`), CI와 같은 검사를 실행한 뒤, 이미 배포된
123
- 버전이면 게시를 거부합니다. 통과하면 npm trusted publishing으로 게시합니다.
124
- GitHub OIDC(`id-token: write`)를 쓰고 npm 토큰은 쓰지 않으므로, 패키지의
125
- trusted publisher에 이 저장소의 `publish.yml`이 등록되어 있어야 합니다.
119
+ `PLAN_ID`에는 plan이 출력한 id, `CONFIRMATION`에는 digest 마지막 12자, `CHANGE_ID`에는 apply가 출력한 id를 넣습니다. 모든 값은 그대로 바꿔 넣는 인자이며 꺾쇠괄호를 직접 입력하지 않습니다. `approve`는 1회용 승인을 만들고, `apply`는 workflow 파일 하나의 계획된 바이트 범위만 고치며, `revert`는 그 변경의 백업을 복원합니다. 결과 diff를 검토하고 필요하면 저장소 검사를 실행합니다. CI Diet는 커밋, 푸시, 배포, workflow 실행, 브랜치 보호 변경, artifact 삭제를 하지 않습니다.
120
+
121
+ 대상이 PR 전용 CI인 CD001 예시의 `ci-only`와 `replace-safe`는 사람의 attestation입니다. 취소 의미를 운영자가 검토했다는 진술이며 우회 스위치가 아닙니다. CD005에는 측정된 `--job`과 `--minutes`가 필요하고, CD008에는 `--job`, 대상 step의 0부터 시작하는 숫자 `--step` 배열 인덱스, artifact claims가 필요합니다. CD006에는 `--job`과 setup-node step의 0부터 시작하는 `--step` 인덱스가 필요하며 claims는 없습니다. 두 step 규칙의 숫자 step은 step 이름 토큰이 아니라 배열 인덱스입니다.
122
+
123
+ ## 상태와 한계
124
+
125
+ CLI와 플러그인은 기본 상태 저장 경로를 공유합니다. Windows에서는 `%LOCALAPPDATA%\CI-Diet\profiles\default`, 그 밖에서는 `~/.local/state/ci-diet/profiles/default`입니다. 플러그인의 `stateDir`를 바꾸면 별도 저장소가 되므로 `plan`, `approve`, `apply`, `revert`마다 CLI에 같은 절대 경로를 `--state-dir`로 전달합니다. CLI의 상대 `--state-dir`는 적용된 `--cwd` 기준으로 해석됩니다. 기존 상태를 다른 디렉터리로 자동 이전하지 않습니다.
126
+
127
+ Web 클라이언트에는 설정 화면과 **CI Diet Reports** 검토 화면이 있습니다. 보고서·승인·적용·되돌리기 UI는 앞선 커밋에서 실제 브라우저 E2E를 통과했습니다. 기본값 마이그레이션은 DSH `0.2.1-rc.2` 런타임의 configEditor, SettingsForms, Loader와 임시 프로필에서 별도로 검증했습니다. legacy `false` 값이 `true`로 저장되고, 나중에 명시한 `false`가 재시작 뒤에도 유지되는 것까지 확인했으며 새 브라우저 렌더 검증은 아닙니다. 승인과 적용은 이 화면에서 호스트로 요청하며 `localApplyEnabled`는 기본으로 켜져 있습니다. 승인이나 적용을 하는 플러그인 도구는 없습니다. plan은 기존 workflow 파일 하나를 바이트 범위로 수정하며 지원하지 않는 구조는 거부합니다. 이력이나 workflow 매칭이 일부만 수집되면 발견이 틀리거나 빠질 수 있고, 실제 청구 정보는 다른 시스템이 더 정확할 수 있습니다. 보고서를 검토 근거로 쓰고 GitHub에서 효과를 따로 확인합니다.
128
+
129
+ ## 비용과 근거
130
+
131
+ | 필드 | 의미 |
132
+ | --- | --- |
133
+ | `observedRunnerSeconds` | 수집한 실행에 기록된 러너 시간 |
134
+ | `modeledRoundedMinutes` | 모델링을 위해 job별로 올림한 분 |
135
+ | `listPriceUsd` | 보고서에 넣은 정가 스냅샷 기준 비용 |
136
+ | `actualBilledUsd` | 실제 청구를 증명할 수 있을 때까지 항상 `null` |
137
+
138
+ 보고서에는 가격 스냅샷과 콘텐츠 해시를 넣어 숫자를 다시 재현할 수 있게 합니다. 자동 절감을 주장하지 않습니다. HTML 보고서는 인라인 CSS만 쓰며 스크립트와 외부 요청이 없습니다.
126
139
 
127
- ## 요구 사항
140
+ ## 언어
128
141
 
129
- - Node `^22.19.0 || >=24.0.0`
130
- - `gh` CLI(선택): 실행 이력 조회에만 사용
131
- - DSH `>=0.2.1-rc.2 <0.3.0-0 || >=0.2.2-rc.1 <0.3.0-0`(선택): 플러그인 도구에만
132
- 사용
142
+ DSH 설정 UI, CLI 메시지, HTML 보고서, 이 여섯 README는 영어, 한국어, 중국어 간체, 힌디어, 스페인어, 프랑스어를 지원합니다. 상세 명세는 영어로만 제공합니다. 선택 순서는 `--lang`, DSH locale, `LC_ALL`/`LC_MESSAGES`/`LANG`, 영어입니다. CLI 언어 코드는 `en`, `ko`, `zh-Hans`, `hi`, `es`, `fr`이며 예시 명령의 `ko`를 원하는 코드로 바꿉니다. 지역 태그는 언어로 해석합니다. 보고서는 영어로 저장하고 표시할 때 번역합니다. 규칙 ID, 오류 코드, 열거값, 경로, 해시, 숫자는 그대로 둡니다. HTML의 `lang` 속성은 선택한 locale을 따릅니다. DSH 도구 설명은 플러그인을 로드할 때 고정되므로 DSH 언어 설정을 바꾼 뒤 다시 로드합니다.
133
143
 
134
144
  ## 개발
135
145
 
@@ -143,51 +153,39 @@ bun run lint
143
153
  bun run test:docs
144
154
  ```
145
155
 
146
- 테스트는 Node로 실행해 배포 진입점이 Node 호환으로 유지되는지 확인합니다. Bun은
147
- 의존성 관리에만 씁니다.
156
+ 게시 진입점의 Node 호환성을 유지하기 위해 테스트는 Node로 실행합니다. Bun은 의존성 관리에 사용합니다.
148
157
 
149
- ## 구조
158
+ ## 릴리스
159
+
160
+ `package.json`과 맞는 태그를 푸시하면 `.github/workflows/publish.yml`이 시작됩니다. 아래 두 인자의 `VERSION`을 새 버전으로 바꿉니다. `0.3.1`은 이미 게시되었으므로 그 태그를 다시 만들지 않습니다.
150
161
 
151
162
  ```
152
- src/core workflow 파싱, 규칙, 절감 계산, 패치 엔진
153
- src/adapters github, git, storage
154
- src/dsh 호스트·클라이언트 플러그인 코드
155
- src/cli 명령줄 진입점
156
- src/shared i18n과 작은 공용 도구
157
- contracts 설계 팩에서 가져온 JSON Schema
158
- examples 합성 예제와 검산 벡터
159
- docs/spec 규범 제품 명세
160
- scripts 계약·문서 검사 스크립트
161
- tests/unit 네트워크가 필요 없는 빠른 검사
163
+ git tag vVERSION
164
+ git push origin vVERSION
162
165
  ```
163
166
 
164
- ## 언어
167
+ 워크플로는 태그와 `package.json`을 대조하고 릴리스 검사를 실행합니다. 이미 존재하는 npm 버전은 거부하며 GitHub OIDC 기반 npm trusted publishing으로 게시합니다. trusted publisher에는 `publish.yml`을 등록해야 합니다.
165
168
 
166
- 영어가 기본이며 메시지 키의 단일 소스입니다. CLI, HTML 보고서, DSH 도구 문구는
167
- 영어·한국어·중국어 간체·힌디어·스페인어·프랑스어로 제공하며, 모든 사전이 완역이라
168
- 키가 빠지면 타입 오류가 납니다. 지역 태그는 언어로 해석하고(`hi-IN`, `es-MX`,
169
- `fr-CA`), 간체가 아닌 중국어 변형은 영어로 대체합니다.
169
+ ## 구조
170
170
 
171
- 언어 선택 순서는 `--lang`, DSH 언어 설정, `LC_ALL`/`LC_MESSAGES`/`LANG`,
172
- 영어입니다. 보고서는 영어로 저장하고 표시할 때만 번역합니다. 규칙 ID, 오류 코드,
173
- 열거값, 경로, 다이제스트, 수치는 번역하지 않으며 HTML 보고서의 `lang` 속성은
174
- 선택한 언어를 따릅니다. DSH 도구 설명은 플러그인 로드 시점에 고정되므로 DSH
175
- 언어 설정을 바꾸면 다시 로드해야 합니다. 공개 문서는 영어이고 README만 한국어로
176
- 미러링합니다.
171
+ ```
172
+ src/core workflow parsing, rules, savings, patch engine
173
+ src/adapters GitHub, git, storage
174
+ src/client Web Settings and review UI
175
+ src/dsh host plugin and bundle code
176
+ src/cli command-line entry
177
+ src/shared i18n and shared helpers
178
+ contracts JSON Schemas from the frozen design pack
179
+ examples sample records and evaluation vectors
180
+ docs/spec normative specification
181
+ scripts contract and documentation checks
182
+ tests/unit fast checks that need no network
183
+ ```
177
184
 
178
185
  ## 문서
179
186
 
180
- - 명세: [docs/spec/README.md](docs/spec/README.md)
181
- - 규칙: [docs/spec/rules.md](docs/spec/rules.md)
182
- - 비용 모델: [docs/spec/cost-model.md](docs/spec/cost-model.md)
183
- - 패치 모델: [docs/spec/patch-model.md](docs/spec/patch-model.md)
184
- - 저장·오류: [docs/spec/storage.md](docs/spec/storage.md)
185
- - 결정 기록: [docs/spec/decisions.md](docs/spec/decisions.md)
186
- - 측정: [docs/spikes/a0a-rules.md](docs/spikes/a0a-rules.md)
187
- - 플러그인·CLI 안내: [docs/guide/plugin.md](docs/guide/plugin.md)
188
- - 계약 출처: [contracts/UPSTREAM.md](contracts/UPSTREAM.md)
189
- - English: [README.md](README.md)
187
+ 상세 명세, 규칙, 비용, 패치, 저장, 결정 문서는 **영어**로 작성되어 있습니다. 명세 색인은 [docs/spec/README.md](docs/spec/README.md)입니다. [규칙](docs/spec/rules.md), [비용 모델](docs/spec/cost-model.md), [패치 모델](docs/spec/patch-model.md), [저장·오류](docs/spec/storage.md), [결정](docs/spec/decisions.md), [측정](docs/spikes/a0a-rules.md), [플러그인·CLI 안내](docs/guide/plugin.md), [계약 출처](contracts/UPSTREAM.md)도 볼 수 있습니다.
190
188
 
191
189
  ## 라이선스
192
190
 
193
- MIT
191
+ MIT