feat(daily-evolve): self-evolution pipeline (Phase 0~6 + 1.5a + budget) — Codex pair R1-R3 0 수렴 - #1

…st cap)

plan §Phase 1 — Codex L3 Triage Orchestrator + cognitive load metric + median
baseline cost cap.

## 추가 lib (pure, R2-L2)
- triage-metric.mjs — decision_count (3분류 별) / estimated_reading_minutes
  (CJK+ASCII word count / 200wpm) / manual_actions_required / 30min budget alert
- cost-cap.mjs — median + computeCap (baseline median × 3, initial=20) +
  appendBaseline (last 7 FIFO) + SKIP_REASONS enum (CLAUDE.md taxonomy)

## 추가 orchestrator
- codex-triage.mjs — N≥3 fan-out + cost cap + heuristic stub (Phase 1 PoC,
  actual Codex pair 호출은 Phase 1.5+):
    FIXED/WONTFIX → autonomous_safe
    QUESTION → needs_claude_judgment
    PARTIAL/NOT-FIXED → needs_user
  - state/daily-evolve-cost-baseline.json lazy create (사용자 default #5)
  - state-migrator 통합 + corrupt JSON backup `.corrupt-${ISO}.bak`
  - cap exceeded → 모두 needs_user fallback + skip_reason=cost_cap_exceeded

## 통합
- digest-writer.mjs — triageSummary inject 시 metric header (table) +
  Codex L3 Triage Summary 박스 출력. Phase 0 호환 (triageSummary 부재 시 simple metric)
- codex-companion.mjs handleDailyEvolve — `--phase 1` 시 triage 호출 +
  결과 inject. phase > 1 차단 메시지 update

## 검증
- 신규 23 unit tests (triage-metric 8 + cost-cap 8 + codex-triage 7)
- daily-evolve unit tests 95 → 118/118 pass. 회귀 0
- node --check 모든 신규/변경 .mjs 통과
- lib dependency rule guard 가 신규 lib 2개 자동 cover (readdirSync glob)

Phase 2 (Active Fork Research + L7 Codex 케이스별 가중치 조정) 대기.

- M1 phase_reached: handleDailyEvolve 의 ledger entry 의 phase_reached 가
  항상 0 으로 hard-code 되어 있었음. `phase_reached: phase` 로 변경하여
  Phase 1 실행 시 1, Phase 0 시 0 으로 정확 기록 (plan §Run Status Ledger
  schema 의 "0 | 1 | 2 | 3 | 4" 계약 준수)
- M2 reading metric 2-pass: digest-writer 의 estimateReadingMinutes 가
  cognitive load 섹션 직전까지의 markdown 만 보고 계산해 30분 budget 초과를
  놓칠 위험. placeholder 토큰 패턴으로 변경 — records 섹션까지 모두 push
  완료 후 final markdown 기준으로 metric 계산, splice 로 placeholder 위치
  replace. Phase 0 호환 유지 (triageSummary 부재 시 기존 simple metric)
- L1 cost_units_blocked: cap exceeded 시 cost_units=0 (실제 미호출 비용) 외
  cost_units_blocked 필드 추가하여 차단된 예상 비용 surface (운영 분석 시
  누락된 수요량 추적). digest-writer 에서도 cost_units_blocked 부재 시
  표시 안 함 (Phase 0/일반 경우 호환)

검증: daily-evolve unit tests 118/118 pass. 회귀 0.
Codex Phase 1 batch review (agentId a768bbc446ecff4c6) 의 MEDIUM/LOW 적용본.

plan §Phase 2 — opnd-io/opnd-codex-plugin 의 fork ecosystem 탐색, fork 별
import-candidate 추출 + Codex L7 케이스별 가중치 조정 (PoC heuristic stub).

## 추가 lib (pure, R2-L2)
- fork-ranking.mjs — 5-axis baseline score (recency 0.30 / matching 0.25 /
  unique 0.20 / diversity 0.15 / ratio 0.10) + isActive 정의 (pushed<30d /
  ahead≥5 / authors≥2 / non_vendor≥0.3 / not archived) + RENAME_MAP
  effective_after 2026-05-20 (PR #8 rename 보존) + LICENSE_WHITELIST +
  applyL7Adjustment (boost 1.3 / demote 0.7 / maintain / insufficient_info)
  + selectTopN (longest-prefix 매칭으로 sub-directory baseline cover 정확)
- fork-tarball.mjs — vendor path/file patterns + binary
  extension/size(1MB)/magic 검출 + nonVendorDiffRatio + normalizePosixPath

## 추가 orchestrator
- fork-research.mjs — gh api forks list + license filter + per-fork compare
  (budget guard ≤19 API/run) + active check + Top N=10 baseline score +
  L7 heuristic stub (boost/demote/maintain/insufficient_info, Phase 2 PoC
  — actual Codex pair 호출은 Phase 2.5+) + Top N=5 final (austerity
  mode N=3 trigger) + IMPORT-CANDIDATE record 변환

## 통합
- codex-companion.mjs handleDailyEvolve — `--phase 2` 시 forkResearch()
  호출 후 records 를 analyzed 에 append → triage → digest. phase 0/1 호환
- digest-writer.mjs — forkSummary inject 시 "Phase 2 Active Fork Research
  Summary" 박스 출력 (total / license_skipped / active / top_candidates /
  l7_calls / l7_cost_units / api_calls / n_final / austerity_mode)

## 검증
- 신규 36 unit tests (fork-ranking 18 + fork-tarball 9 + fork-research 9)
- daily-evolve unit tests 118 → 154/154 pass. 회귀 0
- longest-prefix 매칭 fix — sub-directory baseline (scripts/lib/ vs scripts/)
  정확 cover

Phase 3 (7-source 통합 — memory/Unreleased/TODO/telemetry UX) 대기.

- M1 austerity trigger: forks > 50 시 N_AUSTERITY(10→3) 축소 적용
  (Plan §L7 cost trigger). cost_units 누적 비교는 cost-cap baseline 통합
  후 Phase 2.5+
- M2 stars desc pre-sort: license filter 후 stargazers_count desc +
  pushed_at desc tie-break 정렬. budget cap 도달 시 high-value fork 우선
  enrich 보장
- M3 JSON parse silent null observability: ghApi 의 JSON.parse fail catch 가
  silent null 반환 → stderr 에 error message + stdout head 80 char 로
  shape drift 원인 추적 가능

검증: daily-evolve unit tests 154/154 pass. 회귀 0.
Codex Phase 2 batch review (agentId a7ee67eaacecb386d) 의 MEDIUM 3건 적용본.

plan §Phase 3 — memory/Unreleased/TODO/UX 4 sub-source 추가 + lib/pii-redact.

## 신규 lib (pure, R2-L2)
- pii-redact.mjs — Email RFC 5322 / GitHub PAT (ghp_*/gho_*/ghs_*/ghu_*) /
  OpenAI sk-* / Slack xox* / 40-hex / Windows `C:\Users\...` / POSIX
  `/home/...` `/Users/...` `/tmp/...` 절대경로 마스킹. <email>/<token>/<path>
  마커 (grep 친화). containsPii / redactAll / hits 카운트

## source-aggregator 4 sub-source
- readMemoryFeedback — `~/.claude/projects/.../memory/feedback_*.md` scan
  (size + mtime + 500char preview)
- readUnreleasedGap — CHANGELOG `## Unreleased` 의 백틱 path/ref ↔ fork
  코드 grep diff → 미매칭만 surface
- readStaleTodos — `(TODO|FIXME)` grep + git blame author-time, ≥30d stale
  + 100 hit cap (cost guard)
- readFailureCluster — telemetry errorMessage top 5 cluster count

## diff-analyzer signal_type 4 분류
- failure cluster → NOT-FIXED + telemetry-ux (이전 QUESTION stub 강화)
- memory feedback → QUESTION + memory-drift
- unreleased gap → PARTIAL + unreleased-gap
- stale TODO → PARTIAL + todo-stale

## digest-writer PII 통합
- record 의 surface field (preview/body/error_message/title) 모두
  redactAll 적용 후 출력. 새 record 객체 immutable (mutation 없음)
- hits 누적 카운트 (digest 향후 PII notice 활용 가능)

## companion phase 분기
- phase > 3 차단 메시지 (Phase 0-3 only)

## 검증
- 신규 8 unit tests (pii-redact): email/token/path mask + containsPii +
  multi-pattern + lastIndex reset
- daily-evolve unit tests 154 → 162/162 pass. 회귀 0

Phase 4 (Action Executor + L5 협의 + autonomous PR draft + dedupe 7d cache) 대기.

…raft 후보

plan §Phase 4 — autonomous-safe → L5 heuristic → PR candidate / needs_user
/ skip 분기. 7d dedupe cache + 5 PR 동시 cap + draft only.

## 신규 lib (pure, R2-L2)
- action-policy.mjs — L5 heuristic stub (signal_type+verdict 기반: TODO_STALE
  ≥30d→pr_draft / UNRELEASED_GAP→needs_user / TELEMETRY_UX→needs_user(HIGH)
  / MEMORY_DRIFT→needs_user(HIGH) / FORK_IMPORT_CANDIDATE→needs_user /
  upstream FIXED→skip / 그 외→skip+low) + isLive 7d TTL boundary +
  pruneCache (immutable) + buildPRBody (verdict+signal_type+L5+dedupe+rollback)
  + L5_DECISIONS / L5_SURFACE_VALUES enum

## 신규 orchestrator
- action-executor.mjs — autonomous_safe filter → L5 협의 → recordDedupeKey
  (verdict+normalized title+sorted paths sha256) 확인 → PR candidate (5 cap)
  or surface (needs_user / skip-with-value) or skip. state/daily-evolve-pr-
  cache.json lazy create + state-migrator + corrupt JSON backup. 5 cap
  초과 시 needs_user 로 strand

## 통합
- companion phase 분기 — `--phase 4` 시 actionExecute 호출 + 결과 inject.
  phase > 4 차단
- digest-writer 의 "Phase 4 Action Executor Summary" 박스 + PR draft
  candidates 목록 (dedupe_key prefix + title)

## 검증
- 신규 22 unit tests (action-policy 13 + action-executor 9)
- daily-evolve unit tests 162 → 184/184 pass. 회귀 0

Phase 4 PoC = L5 heuristic + PR candidate 까지. Actual `gh pr create --draft`
는 Phase 4.5+. Phase 5.0/5 (env probe + scheduled-tasks MCP morning 9 KST) 대기.

…ning 9 KST

plan §Phase 5.0 BLOCKING + §Phase 5 — scheduler_status decision tree +
machine TZ probe + KST 09:00 → local cron 변환 + cron fallback + opt-out.

## 신규 lib (pure, R2-L2)
- env-probe.mjs — SCHEDULER_STATUS enum (UTC_AWARE / LOCAL_TZ_ONLY /
  MCP_UNAVAILABLE / UNKNOWN) + decideSchedulerStatus decision tree +
  kstNineToLocalCron ((TARGET_UTC + offset) mod 1440 / minute fraction
  지원) + buildProbeResult + validateProbe + hasDstRisk (America/Europe/
  Pacific/Auckland true, Asia/Seoul false — DST 봄/가을 1h drift 위험 추적)

## 신규 orchestrator
- schedule-setup.mjs — probeMcpInstalled (`claude mcp list`) +
  probeCronTzSupport (Phase 5 PoC heuristic) + probeMachineTz
  (Intl.DateTimeFormat.resolvedOptions + getTimezoneOffset) +
  state/daily-evolve-env-probe.json lazy create + state-migrator 통합 +
  buildGuidance — scheduler_status 별 등록 명령 / DST 경고 / opt-out 안내
- cron-fallback.sh — install/uninstall/status. CODEX_PLUGIN_DAILY_EVOLVE_
  DISABLED opt-out guard 자동 포함. MCP_UNAVAILABLE 또는 사용자 결정 #2
  시 fallback primary

## companion 강화
- `CODEX_PLUGIN_DAILY_EVOLVE_DISABLED=1` opt-out (exit 0)
- `--probe` flag — env probe 단독 실행 (Phase 5.0 BLOCKING) + guidance stderr

## 검증
- 신규 17 unit tests (env-probe): decision tree 4 branch + cron 변환
  (KST/UTC/LA/India 30분/invalid) + validateProbe + buildProbeResult +
  hasDstRisk + enum
- daily-evolve unit tests 184 → 201/201 pass. 회귀 0

Phase 5 PoC = probe + guidance 까지. Actual MCP registration 은 사용자
manual (`claude mcp call scheduled-tasks create ...`) 또는 cron fallback
(`bash cron-fallback.sh install`).

Phase 6 (Self-Evolve Meta Loop) 대기.

plan §Phase 6 — routine 자체가 매주 self-review. heuristic 조정은 항상
PR draft + 사용자 review 후만 적용 (자동 적용 절대 X).

## 신규 lib (pure, R2-L2)
- self-evolve-policy.mjs — REVIEW_TYPE / CHANGE_TARGETS / DECISION 3 enum
  + isActionable (needs_claude_judgment 제외) + fpRate + buildAttribution
  Window (R5-M3 effective_at + decision precondition + R4-M1 14d/7d disjoint)
  + shouldRollback (1.5× + min 10 actionable) + checkLoopGuard
  (MAX_DEPTH=1 + recursive STOP — self_evolve_* target 차단) +
  shouldFireWeekly (7d trigger) + buildReviewEntry schema

## 신규 orchestrator
- self-evolve.mjs — trigger check + loop guard + telemetry 수집 (runs-YYYY
  last 2 years merge) + Phase 6 PoC stub (empty proposed_changes) +
  weekly report `docs/daily-evolve/_weekly/{YYYY-Www}.md` (ISO week
  Thursday-based) + state/daily-evolve-self-evolve-log.json lazy create

## companion
- `--self-evolve [--type weekly_normal|monthly_self_change] [--force]`
  flag — Phase 6 별도 mode. phase > 5 차단 메시지 + self-evolve 안내

## 검증
- 신규 29 unit tests (self-evolve-policy 21 + self-evolve 8)
- daily-evolve unit tests 201 → 230/230 pass. 회귀 0
- float precision boundary test 회피 (0.301 명확 초과)

## 🎉 plan-daily-evolve-pipeline.md 전 Phase 완료
- Phase 0 (PoC source 2)
- Phase 1 (Codex L3 triage heuristic stub + cost cap)
- Phase 2 (Active Fork Research + L7 가중치 조정)
- Phase 3 (7-source 완전 통합 + PII redact)
- Phase 4 (Action Executor + L5 협의 + dedupe + PR draft)
- Phase 5.0+5 (env probe + scheduled-tasks MCP + cron fallback + opt-out)
- Phase 6 (Self-Evolve Meta Loop)

후속 enhancement (Phase X.5+) — actual Codex L3/L5/L6/L7 호출, actual
gh pr create, MCP 자동 등록 — 별도 PR.

… memory scope

baseline dry-run 평가 후 발견된 3 noise/mismatch fix.

## 1. ledger decision_count + cost_units propagation
이전 hard-code `{0,0,0}` / `0` → triageResult.records 카운트 + L3/L7/L5 cost 합산
(scope hoist 로 try block 밖에서도 finalize block 접근 가능 — 이전 ReferenceError fix)

## 2. exceeds_budget 강화 (manual_actions_required 도 판정)
이전 estimated_reading_minutes 만 봐서 manual_actions 135 cognitive overload 미alert.
이제 reading 30m 초과 OR actions 60 (분당 2 결정 모델) 초과 시 ⚠ surface.
plan §defining constraint (≤30분 morning triage) 의 실제 enforcement.

## 3. memory scope 본 plugin project 만
이전 ~/.claude/projects/* 전체 scan → 다른 프로젝트 feedback 60+건 noise.
이제 cwd hash 매칭 project dir 우선, fallback 으로 plugin keyword
(codex-plugin|daily-evolve|opnd-codex|opnd-io) 포함 feedback 만.

## 결과 (실제 dry-run 검증)
- decision_count: {0,0,0} → {38, 135, 0}
- cost_units_consumed: 0 → 40
- needs_claude_judgment 60 → 0 (memory noise 제거)
- 총 records 232 → 172
- digest: `⚠ exceeds_actions_budget | true — manual 135 > 60` alert 출력 확인

## 검증
- daily-evolve unit tests 230 → 231/231 pass (manual_actions budget test 1 추가)
- 실제 dry-run (87s) 정상 + ledger entry 정확

## Phase X.5 plan 동봉
- `plan-daily-evolve-enhancement.md` — Phase 1.5/2.5/3.5/4.5/5.5/6.5 outline +
  우선순위 (3.5 HIGH source 정밀도 / 1.5 HIGH actual Codex L3 / 4.5 MEDIUM
  actual gh pr create / etc.)

…nv override)

이전 Plan §R1 HIGH-2 의 `API_BUDGET_PER_RUN = 19` 가 100 forks 중 19 만
enrich → fork sample 부족 ("오래 못 돈" 인상). 사용자 평가 후 제거.

## 변경
- API_BUDGET_PER_RUN default = Infinity (제거)
- 단 env var `CODEX_PLUGIN_FORK_API_BUDGET=N` 으로 명시 cap 가능
  (production 환경 또는 1000+ forks 안전망)
- `budget_exceeded` flag 가 Infinity 일 때 false 강제
- research_summary 에 `api_budget` 필드 추가 (default 또는 env 값 노출)
- digest-writer 의 표시 갱신 — Infinity 시 "X (unlimited — env CODEX_PLUGIN_
  FORK_API_BUDGET 으로 cap 가능)" 출력, 유한 budget 시 "X / Y budget" 그대로

## 안전성
- gh API rate limit 5000/h authenticated. 100 forks × 1 compare = 100 calls
  매우 안전. daily 1회 routine 이라 누적 무영향.
- 큰 fork 수 (1000+) 또는 forks list per_page 변경 시 사용자가 env 로 cap

## 검증 (이전 dry-run)
- 100 forks 모두 enrich (api_calls: 101)
- active fork 발견 1 → 2 (이전 budget 19 cap 으로 누락된 fork 추가 발견)
- duration 88s → 128s (40s 증가 — gh API 라운드트립)
- 회귀 0 (daily-evolve unit tests 231/231 pass)

다른 budget (Codex cost cap median × 3 / PR 5 cap / cognitive budget) 은
보호 의미 있어 유지.

… heuristic fallback

사용자 다른 session 의 Codex 만료 영향 후 enhancement 첫 step. routine 시작
시 setup --json health check + 만료 시 heuristic fallback + digest failures
첫 줄 알림 + Phase 6 expiry streak 분석 input.

## 신규 lib (pure, R2-L2)
- auth-health-check.mjs — HEALTH_STATUS 5 enum (READY/CLI_UNAVAILABLE/
  NOT_LOGGED_IN/NOT_VERIFIED/UNKNOWN) + DEGRADE_ACTION 3 enum (PROCEED/
  FALLBACK_HEURISTIC/ABORT) + parseSetupJson (string|object|null) +
  decideDegrade + buildFailureMessage (한국어 + hint) + computeExpiryStreak
  (newest first 가정, NOT_LOGGED_IN/NOT_VERIFIED 연속 카운트) +
  shouldEscalate (streak ≥ 3 → escalate). EXPIRY_STREAK_ALERT_DAYS=3.

## companion 통합
- handleDailyEvolve 진입 시 process.execPath 로 companion `setup --json`
  subprocess (timeout 10000ms) → parseSetupJson → authHealth.
- decideDegrade != PROCEED 시 stderr 알림 (status + degrade + failure msg)
- finalized.auth_health 에 entry 추가 (ledger 의 Phase 6 self-evolve input)
- writeDigest 에 authHealthFailureMessage inject

## digest-writer 통합
- authHealthFailureMessage param 추가
- hasAuthFailure flag → hasFailures 합산
- failures 섹션 첫 줄에 `⚠ ${msg}` 출력 (인증 만료 안내 + hint)

## OAuth 한계 명시
- access token: Codex CLI 자동 silent renew (refresh token 사용)
- refresh token: Codex CLI 자동 rotation (만료 시 새 토큰)
- refresh token expired/revoked: `codex login` 재실행 필요 (browser
  OAuth flow). plugin 이 사용자 대신 수행 불가 (보안 정책).
- 본 Phase 1.5a 는 health check pre-flight + degrade 까지. 사용자 알림
  후 routine 다음 실행부터 정상 복구.

## 검증
- 신규 21 unit tests (auth-health-check)
- daily-evolve unit tests 231 → 252/252 pass. 회귀 0
- 실제 dry-run (사용자 환경 만료 상태): stderr 정확 메시지 출력
  `[daily-evolve] auth health: not_logged_in — degrade=fallback_heuristic
   (Codex auth health: 인증 만료 — \`codex logout && codex login\` 후
   다음 routine 부터 정상 복구)`

## 후속
- Phase 1.5b — actual L3 Codex 호출 시 degrade 활용 (heuristic fallback path)
- Phase 6.5 — expiry streak ≥ 3 시 별도 알림 task 자동 등록
- enhancement plan §Phase 1.5 spec 강화 별도 commit

## 본 commit 의 목적
사용자 명시 "다른 세션에서 이어갈 수 있게 작업 및 세션 정리". Codex CLI
refresh token expired/revoked 상태 — Codex pair batch review + main 머지
미수행 중. 다음 세션이 이어갈 수 있게 state + checkpoint.

## 추가
- checkpoint-daily-evolve.md — 다음 세션 가이드 (현재 상태 / 차단 사유 /
  step-by-step action / Codex pair prompt 별첨 / 사용자 발언 인용 / risk)
- docs/daily-evolve/2026-05-28.md — 첫 dry-run digest (FULL git tracked
  per 사용자 #1)
- docs/daily-evolve/_weekly/2026-W22.md — self-evolve --force 시연 weekly report
- docs/upstream-tracking/2026-05-28/raw.json — 7-source raw cache
- state/daily-evolve-runs-2026.json — run ledger (initial entries)
- state/daily-evolve-cost-baseline.json — Codex cost median baseline
- state/daily-evolve-pr-cache.json — PR dedupe 7d cache (initial empty)
- state/daily-evolve-self-evolve-log.json — Phase 6 weekly review log

## 다음 세션 진입 가이드 (1줄)
`git checkout feat/daily-evolve-pipeline && cat checkpoint-daily-evolve.md`

R1 HIGH 2 + MEDIUM 1 + LOW 1, R2 LOW FIX_PARTIAL → R3 CONVERGED.

## HIGH #1 — parseSetupJson schema mismatch
- lib/auth-health-check.mjs L41-L103: JSDoc schema 실제 setup --json shape
  으로 갱신 (`codex: {available, detail}` + `auth: {available, loggedIn,
  verified, detail, authMethod, source}`)
- parsed.codex.loggedIn/verified → auth.loggedIn/verified 교정
- codex.available 만 CLI_UNAVAILABLE 판정 유지
- 영향: 정상 로그인도 NOT_LOGGED_IN 으로 잘못 degrade 되던 회귀 해소

## HIGH #2 — auth_health.raw PII leakage
- parseSetupJson 의 모든 return 에서 raw: parsed 제거
- 효과: codex-companion.mjs handleDailyEvolve 의 finalized.auth_health =
  authHealth 가 ledger 에 저장 시 auth.detail (ChatGPT login active for
  {email}) PII 가 더 이상 영구 보존되지 않음

## MEDIUM — fileURLToPath() 적용
- codex-companion.mjs L2793-L2802 handleDailyEvolve 의 subprocess argv 구성:
  import.meta.url.replace() 정규식 체인 → fileURLToPath(import.meta.url)
- 효과: UNC / 공백 path portability + dead code 제거

## LOW — real-shape integration fixture
- tests/daily-evolve/auth-health-check.test.mjs:
  - 기존 6 fixture 의 codex: {loggedIn, verified} → 실제 schema (codex: {available}, auth: {loggedIn, verified}) normalize
  - 추가 test: "parseSetupJson — raw 필드 제거 (PII leakage 차단)" — anonymized real-shape 입력 시 raw 부재 + details serialize 시 PII 누설 안 됨
  - 추가 test: "parseSetupJson — real-shape with extra fields → 정상 처리 (R1 LOW regression)" — node/npm/sessionRuntime/nextSteps 같은 추가 필드 robust 검증
  - R2 LOW FIX_PARTIAL fix: CLI_UNAVAILABLE / NOT_LOGGED_IN fixture 에 verified 필드 명시 (full schema 일관성)

## 검증
- node --test tests/daily-evolve/auth-health-check.test.mjs: 23/23 pass
- npm test 전체: 회귀 0 (exit 0)
- Codex pair R1 (a838b13ee29406639) → R2 (aaf4c8ef50122b1da) → R3 (a2a0a860aa55152c4) CONVERGED, Merge GO