GRID.OS 인터널 2.1.1 스펙 브리핑

왜 만드는가 — 2.1(v2.1.0-internal.1)은 원우님이 매일 쓰는 리뷰 빌드로 이미 배포됐고, 그 뒤 빠른 확인·수정 왕복(고속 루프)까지 한 차례 더 돌았습니다. 2.1.1은 그 다음 단계 — 직원 4~5명에게 실제로 나눠줄 수 있는 배포 패키지를 만드는 일입니다.

사용자의 무엇이 달라지는가 — ① 직원용 신규 그리드 첫 화면에 원우님 개인 정보(클라이언트명·개인 위젯 등)가 하나도 안 보이는지 최종 확인(클린룸) ② 직원이 실제로 앱을 다운로드해 설치할 수 있는 DMG 파일 + 암호로 보호된 다운로드 링크 ③ 새로 그리드를 만들 때 온보딩이 처음부터 끝까지 실제로 되는지 확인.

예상 시간 — 파트별 합계 약 16~20시간(v1.2 재산정 — 2트랙 파이프라인 P1→P3 / P2→P4), 벽시계 기준 하루반~이틀 목표(§2) · 진행 방식 — 코덱스가 지휘하고 페이블이 파트 경계마다 확인(§5) · 결정 상태 — 5건 중 4건 확정, D401 1건만 재승인 필요

이번 버전에 들어가는 것

• 클린룸 검증 — 8건 + 패키지 전수 스캔(v1.2 확장) — 지난 버전에서 문구·설정을 중립화한 것이 실제 빈 그리드에서 정말로 안 보이는지 최종 확인 + 설치 파일 안(ASAR·시드·이미지·릴리스노트)까지 원우님 흔적 0건 실측
• DMG 패키징 + 병행 배포 + 데이터 보호 계약(v1.2) — 신규 설치·덮어설치·롤백 3종 실기 검증(이 맥의 새 macOS 계정에서), 무엇을 지키고 어떻게 확인하고 실패하면 어떻게 되돌리는지 문서화, 배포용 DMG + 암호 보호 다운로드 링크
• 온보딩 실검증 + 직원 A/B 교차오염 검증(v1.2) — 신규 직원 그리드를 처음부터 끝까지 직접 만들어보고, 가상 직원 2명이 서로 안 섞이는지도 확인
• 배포 허브 페이지 — 다운로드 버튼 + 소개(그리도스가 뭔지·왜 쓰는지) + 가이드(설치→첫 실행→온보딩→첫 대화, 스크린샷 자리 포함) + 버전 표시·재다운로드 안내, 한 페이지에 함께
• 고속 루프 필수 4건(P5) — 정비함 AI 제안 표시 라이브 전용 재현 · 대화탭 워커 집계 불일치 · macOS 알림 발신자 표시 · 바깥클릭 닫기 결함 스윕(14곳, 최소 판별까지 필수)
• 고속 루프 잔여 7건(시간 될 때, P5) — 메인 AI 실배선 · 진행 알약 재설계 · 사고과정/스크롤 한계 문서화 · 온보딩 웹 동행 가이드(배포 허브 페이지로 이미 통합) · 세션 전환 UX · 도구 표시 품질 · 코덱스 오케 워커 진행 확인 필요
• 기술 정리 1건 — 태스크 데이터 저장 방식을 더 안전하게(2.1에서 위험한 부분만 먼저 고치고 나머지를 이번으로 넘긴 것), 실패·복구 기준 명시(v1.2)

들어가지 않는 것 — 이미 끝났거나(2.1) 다른 시점 몫

• 2.1 안에서 이미 끝난 것 13건 — 정비함 버튼 수리·에이전트 패널·알림 복원·모델/도구 관련 소소한 개선·코덱스 오케 라우팅(안내 주입) 등(§3-⑤ 목록 그대로)
• 모바일 접속 · 업무보드 관련 별도 트랙 · 인앱 브라우저 · 큰 보안 봉인 작업 — 전부 원우님이 아직 결정 안 했거나 별도 스트림 몫

부대편성 — 개발 운영방식 정본 §04를 그대로 따름

이 편성은 새로 만든 규칙이 아니라, GRID.OS 개발 운영방식 정본(§04 조직·모델 편성)이 원래 정해둔 방식을 이번 스트림에 그대로 적용한 것입니다.

지휘 — 빌드 대장은 코덱스(Sol high~xhigh). 정본이 "전수조사·증거 결속·이관·패키징처럼 기계 정밀함이 중심인 스트림은 코덱스가 지휘"라고 이미 정해둔 조건과 이번 작업(DMG 패키징·클린룸 전수 검사·설치 검증)이 그대로 맞습니다. 페이블은 감리 — 지휘가 아니라 검문입니다. 두 헤드가 동시에 실행을 판단하는 구조가 아닙니다(정본이 "지휘 이원화 금지"를 명시).

상설 역할(모자) — 구체 임무

코덱스 지휘 + 페이블 감리 — 무슨 뜻인가

이번 스트림은 코덱스가 실제 작업을 주도합니다. 대신 안전판 두 겹을 둡니다 — ① 각 파트가 끝날 때마다 페이블이 가볍게 한 번씩 확인(문제 없으면 그냥 넘어감) ② 되돌리기 어려운 일(실제 빌드 확정·실제 배포)은 페이블이 "승인 파일"을 직접 만들어주기 전엔 코덱스가 손대지 못합니다.

흐름도

원우: 시동 프롬프트 실행 → 퇴근
        │
        ▼
   [코덱스] GO/NO-GO 대기 (최대 12시간, 아직 시작 안 함)
        │
        ├─ NO-GO 감지 ──▶ 착수하지 않고 종료(⓪ 실패)
        ├─ 12h 경과 ──▶ BLOCKED 기록 후 종료
        │
        ▼  (페이블: 고속루프 마무리 → 전체 관문 → internal.3 배포)
   GO 파일 생성
        │
        ▼
   [코덱스] P1 실행(자유 — 아직 관문 없음) ──▶ 체크포인트 기록
        │                  │
        │           [페이블 검토] ──▶ PASS 또는 HOLD 파일 필수(무응답=대기)
        ▼                  │
   PASS 확인 → 그 DMG를 출시 후보로 확정(빌드 관문 승인) → P2 실행 ──▶ 체크포인트
        │                  │
        │           [페이블 검토] ──▶ PASS/HOLD
        ▼
   … P3(확정된 DMG 사용) → P4 → P5(같은 패턴 반복) …
        │
        ▼
   배포 관문 ──▶ 페이블 승인 파일 없으면 대기(페이블 확인 후 승인)
        │
        ▼
   [코덱스] 배포 실행 → 완료 보고
        │
        ▼  (비동기, 배포를 막지 않음 — R8)
   [코덱스] 후단 감사 실행 → 발견 항목 차기 백로그에 자동 등재
        │
        ▼
   페이블 최종 확인 → 종료

v1.2에서 바뀐 점: 페이블 검토는 이제 "말 없으면 통과"가 아니라 PASS/HOLD를 명시해야 합니다. "빌드" 관문은 P1 자체를 막지 않고, P1이 만든 결과물을 출시 후보로 확정하는 시점에만 걸립니다(자체 검증에서 발견된 순환 대기 문제를 이렇게 풀었습니다). 봉인(보안) 감사는 배포 뒤로 옮겨져 더 이상 관문이 아닙니다(R8).

지금 원우님이 하실 일

위 §4에서 D401만 다시 골라 주세요. 재승인되면 코덱스 세션에 §8(이 화면 하단)의 시동 프롬프트를 붙여넣고 실행한 뒤 퇴근하시면 됩니다 — 실제 작업은 페이블이 선행 작업(⓪)을 끝낸 뒤 자동으로 시작됩니다.

문제가 생길 수 있는 지점 — 버전 번호를 새로 매길 때 4곳(앱 버전 라벨·lock 파일·테스트 DMG 스크립트·빌드 라벨) 중 하나를 놓치면 배포 직전에 실패가 뜰 수 있음(2.1에서 실제로 1곳을 놓쳤던 적이 있어 이번엔 체크리스트로 미리 막습니다). 관문(빌드 확정·배포, 조건부로 봉인) 앞에서 페이블 승인 파일이 없으면 코덱스가 거기서 멈춥니다 — 오작동이 아니라 설계된 안전 정지입니다. v1.2 보강 — 페이블이 "괜찮다"는 말을 깜빡해도 예전엔 조용히 통과됐는데(자체 코덱스 검증이 지적한 허점), 이제는 명시적으로 PASS/HOLD를 남겨야만 다음 파트로 넘어갑니다.

사용자 데이터 보호 — 원우님 그리드 데이터·업무 정본은 이번 스펙에서 전혀 건드리지 않습니다. 직원용 신규 그리드만 대상입니다. v1.2 보강 — 설치·덮어설치·롤백 전 과정에서 무엇을 지키는지(그리드 markdown·앱 설정·스냅샷)와 실패 시 되돌리는 절차를 문서로 남기는 걸 이번 스트림의 정식 산출물로 넣었습니다(규모 L3 재분류에 따른 요구사항).

되돌리는 방법 — DMG는 이전 버전 DMG를 재설치하는 방식으로 되돌립니다(그리드 데이터·설정이 실제로 보존되는지까지 실기로 확인). 원우님 기기는 기존과 같은 방식(canonical 재승격)으로 되돌립니다. 준비 단계(⓪)가 실패하면 코덱스는 아예 착수하지 않고 조용히 종료합니다(NO-GO 신호, v1.2 신설) — 어중간하게 시작했다가 막히는 상황을 원천 차단합니다.