Skip to content

v0.29.1 — 0.29.0 문서 정합 + 구형 설치본 진단

Latest

Choose a tag to compare

@sol5288 sol5288 released this 08 Sep 14:05

Fixed

  • 0.29.0 이 바꾼 규칙을 문서가 따라오지 못하던 것을 고쳤습니다 — 배포 뒤 문서를 전수 점검해 7군데를
    정정·보완했습니다. 코드는 맞았고 설명이 틀렸습니다.
    • 🔴 가장 중요: CHANGELOG 조각 규약이 "REQ 는 ## Unreleased 를 직접 고치지 않는다" 라고
      무조건으로 적혀 있었습니다. 실제로는 changelog.d/ 를 커밋한 프로젝트에서만 적용됩니다 —
      규약을 쓰지 않는 독자에게는 "이 도구를 쓰면 내 CHANGELOG 를 못 고친다" 로 읽혔습니다.
    • 위임 원장을 아직 단일 파일로 설명하던 곳(설정 문서 한/영)을 샤드 경로 + legacy 읽기 전용
      보존으로 고쳤습니다.
    • 병렬 REQ 운용 절차가 어디에도 없었습니다(0.29.0 의 핵심 기능인데 "가능해졌다"만 있고 방법이
      없었습니다). 워크플로 문서 한/영에 절차 다섯 항목을 넣었습니다.
    • 보장 문서에 병렬의 한계(두 REQ 가 같은 파일을 고치면 합쳐진 결과를 아무도 검사하지 않는다)를
      "보장하지 않는 것"으로 명시했습니다.
    • README 명령 표에 changelog collect 가 빠져 있었고, 업그레이드 문서에 0.28.x → 0.29.0 절이
      없었습니다(할 일이 없다는 사실도 안내입니다).

Added

  • 문서 축 가드(docs-0290-axes) — 0.29 가 바꾼 규칙 7개를 각자의 정본 문서에 고정합니다.
    한쪽 언어만 고쳐 다른 쪽이 거짓으로 남는 실수를 구조적으로 막습니다.

    확인할 파일: docs/workflow.md · docs/guarantees.md · docs/upgrade.md · README.md(+ 영문)

Fixed

  • 🔴 구형(vendored) 설치본이 옛 코드를 조용히 실행하던 것을 알려 줍니다
    package.jsonreq:*tsx scripts/req/*.ts 형태이면 명령이 저장소에 복사된 사본
    실행합니다. 그런데 그 사본을 갱신하는 명령이 없고(sync --scriptspackage.json 의 누락 키만
    넣습니다), req:doctor 의 D19 는 두 형태가 섞였을 때만 알렸습니다. 결과적으로 패키지를 여러
    릴리스 올려도 새 동작이 도달하지 않은 채 아무 신호가 없었습니다.

    • 이제 순수 Stage A 도 WARN 하고 전환 명령(npx commitgate migrate --apply)을 함께 냅니다.
    • ⚠️ 차단하지 않습니다. Stage A 는 결함이 아니라 지원되는 설치 형태입니다 — 바뀐 것은
      "막지 않는다" 가 아니라 "말해 주지 않는다" 쪽입니다.
    • CommitGate 저장소 자신은 Stage A 형태이므로 개발 저장소에서는 이 경고가 나오지 않습니다.
  • D-체크 정본 표가 "구현된 검사는 21개(D2~D27)"라고 적고 있었습니다 — 실제는 29개(D2~D35) 입니다.
    D28~D35 를 추가한 8개 REQ 가 전부 이 문장을 지나쳤습니다. 표 자체는 맞았고 표를 설명하는 문장
    낡아 있었습니다.

    • 이제 이 수치를 등록부에서 파생해 대조합니다 — 문서와 코드 어느 쪽이 움직여도 검사가 실패합니다.
  • 위 변경과 함께, "D19 는 mixed 만 WARN 한다" 는 폐기된 서술이 SSOT 7개 파일과 업그레이드 문서
    한/영에 남아 있던 것을 전수로 걷어냈습니다. 같은 서술이 다시 들어오면 실패하는 가드를 넣었습니다.

    확인할 파일: scripts/req/req-doctor.ts · docs/ssot-design/07-business-rules-and-state-machines.md