Skip to content
This repository was archived by the owner on Oct 20, 2026. It is now read-only.

v5.43.0 — v3 work-item registry 완성 (Sprint 1~6)

Choose a tag to compare

@jay-swk jay-swk released this 15 May 23:34
· 71 commits to main since this release

Highlights

v3 work-item registry — Nova 플러그인 사용자 프로젝트를 위한 단일 진실원 시스템.

  • 단일 쓰기 경로: 9 진입점 + orchestrator만 scripts/registry-write.sh 호출. sub-agent 직접 쓰기 금지.
  • 5상태 enum 동결: proposed | active | blocked | done | superseded (절대 늘리지 않음)
  • 원자적 전이: Evaluator PASS = status=done + review_required=false + evidence.commit_sha 동시 적용
  • 자동 렌더: NOVA-STATE.md marker 영역(<!-- nova:registry-rendered:start/end -->)만 갱신, 외부 byte-level 보존
  • drift 18 룰: Hard 9 (배포 차단) + Warn 9 (경고). 순차 실행 (H1 실패 시 SKIP)
  • 자동 마이그: v2 STATE → v3 work-item 변환 + 5 PoC 규칙 (priority=medium·commit_sha 부재→proposed·...)

산출 (전체)

신규 스크립트 (6)

  • scripts/registry-write.sh (689줄) — 5명령 + flock/mkdir lock + .pending-transition 마커
  • scripts/registry-render-state.sh — marker 영역 자동 렌더, priority 정렬
  • scripts/registry-drift-check.sh — Hard 9 + Warn 9 = 18 룰
  • scripts/migrate-state-v3.sh — Python 파서, 이모지 헤더/Recent Activity 변형 지원
  • scripts/setup.sh — idempotent 부트스트랩 + .gitignore marker 블록
  • scripts/reindex-work-items.sh — UUID fallback → 정규 순차 회수

신규 테스트 + fixture (5)

  • tests/test-channel-race.sh (N=20 동시 create UUID fallback 0 검증)
  • tests/test-stale-lock.sh (SIGKILL stale lock 자동 정리)
  • tests/perf/500-items-bench.sh (P95 30ms ≪ 200ms — BMad 무너짐 회피 입증)
  • tests/test-sprint2-integration.sh (Plan→Design→Run→Review e2e 7단계)
  • tests/fixtures/drift-cases/{h6,h8,h9,w6}/ (인위 위반 fixture, 모두 정확 발화)

Schema + 가이드

  • docs/templates/schema/{work-item,index}.schema.json — JSON Schema (3 invariant allOf if/then)
  • docs/templates/nova-readme.md — 사용자 .nova/README.md 템플릿
  • docs/guides/sibling-migration-v3.md — TL;DR + 8단계 + FAIL 시나리오 + 7 형제 순차 권장

16 파일 통합 매트릭스 (state-call-graph-v3.md §2.1)

  • 8 진입점 갱신: plan, design, deepplan, run, review, check, ux-audit, audit-self
  • 3 skill 갱신: orchestrator(Phase 7), deepplan(Phase E), context-chain(marker 카운트 제외)
  • 5 변경 없음 (정책): evolve, evaluator, ux-audit skill, strategic-compact, audit-self skill X — sub-agent 정책 유지

검증

  • tests/test-scripts.sh: 923/923 ALL PASS (Sprint 1~6 누적 74 신규 회귀 가드)
  • migrate-state-v3 e2e: 10/10 보존, blocked_reason 자동 추출, commit_sha 부재→proposed 강등
  • drift fixture: H6/H8/H9/W6 모두 정확 발화 (JSONL 출력)
  • sprint2-integration: 7/7 PASS, marker 외 byte-level 보존, 6 이벤트 모두 schema v3
  • 형제 12 레포 dry-run: 12/12 성공, 총 105 work-item 변환 가능 (swk-ground-control 21건 포함)

다음 단계 (사용자)

  1. 형제 프로젝트 마이그레이션 — docs/guides/sibling-migration-v3.md 참조
  2. nova-landing부터 순차 (가장 단순), 각 0.5~1일

설계 (43 누적 Critic 0 미해결, α 적대적 통합 검토 GO)

  • Plan: docs/plans/work-item-registry-v3.md
  • Design: docs/designs/work-item-registry-v3.md
  • Sprint 0 specs: docs/specs/{work-item-scope,state-call-graph,registry-write-authority}-v3.md

🤖 Generated with Claude Code