업데이트 (Updates)

시간축 4-페이지 분리 (D-docs-updates-1, 2026-05-22):

페이지	시간	용도
roadmap	미래	분기 마일스톤 (M1~M5)
backlog	현재	1주 안 행동 큐
본 페이지	과거	ship 별 changelog + 큐레이션 highlights
known-gaps	(사실)	함정·미해결

본 페이지는 3 섹션:

1. Ship Log — 매 axe ship SERVICE 마다 한 줄 자동 기록 (Phase 2: B-axe-ship-update-hook). Phase 1 (현재) = 수동 append. 정직 채널, 운영 회고용.
2. Highlights — 사람 큐레이션. 의미 있는 변경만 narrative (직원·외부 IT 용).
3. API feed — /api/changes JSON endpoint. LLM agent 가 “지난 N일 변경” fetch.

Ship Log

매 ship 의 한 줄. 2026-MM-DD HH:MM — SERVICE ship — COMMIT-SUBJECT (commit hash + service stack).

Phase 1 (수동 append) — 운영자가 axe ship SERVICE 후 한 줄 추가. Phase 2 (완전 자동) — backlog 의 B-axe-ship-update-hook 항목.

Highlights

큐레이션. 의미 있는 변경만, narrative. 직원·외부 IT 가 “지난 한 달 무엇이 새로 생겼나” 5분 안에 파악.

등재 절차: 운영자가 1-2 주에 한 번, Ship Log 와 backlog ✅ 항목을 검토하고 narrative 한 단락 작성.

2026-05-22 ~ 23 — Vault end-to-end 셋업 + axep entity 신설 + customer 일반화

axe customer 의 Vaultwarden 을 6명 (operator 4 + 2 dual-identity) 사용 가능 상태로 본격 셋업. 첫 employee SSO 시도부터 5 시리얼 함정 해결 → 결정 9 건 (D-ops-24 ~ D-ops-33):

• D-ops-24 Entra ID id_token 의 email_verified claim 부재 → Timshel fork 거부 → SSO_ALLOW_UNKNOWN_EMAIL_VERIFICATION=true
• D-ops-26 SIGNUPS_ALLOWED=false 가 JIT user 생성 차단 → “Failed to retrieve the invitation” → SIGNUPS_ALLOWED=true
• D-ops-27 SSO_ONLY=false 유지 (Entra 장애 emergency MP fallback) + ORGANIZATION_INVITE_AUTO_ACCEPT=true (직원 Accept 자동)
• D-ops-28 bw CLI 2026.4.1 ↔ Timshel 1.34.1-6 호환 미스매치 (toWrappedAccountCryptographicState crash) → CLI 2025.7.0 다운그레이드. 항구 해소는 B-vault-upstream-migration (dani-garcia/vaultwarden:1.36.0 native SSO)
• D-ops-29 dual-identity 패턴 (ai@ automation / soohun.kang@ human Owner) — bot/human sender 혼동 회피
• D-ops-30 Blueprint /api/admin/broadcast-dm endpoint — operator broadcast 1:1 Teams DM (vault onboarding 안내 3명 발송 검증)
• D-ops-31 axep entity 신설 (액스파트너스 유한책임회사) — frame+hive register-entity + customers.yaml + PII passphrase 2개 + frame blue/green + hive sequential. axec/axev 무중단 검증
• D-ops-32 Vault collection 구조 v1 종합 설계 (6-collection: Platform-Service/Platform-Infra/AXEC/AXEV/AXEP/Shared, entity 1개 customer 는 4-collection 변형)
• D-ops-33 axe vault bootstrap {customer} --apply CLI 신설 — D-ops-24/26/27 4-key 적용 자동화. realchoice 6/1 deploy 가 axe 의 5/14~22 시리얼 함정 자동 회피

부수 발견 함정 2건: (a) axe secret push 가 BW_SESSION env 무시하고 macOS Keychain (axe.vault.session) 만 읽음 — 자동화 스크립트가 keychain 갱신 통합, (b) MDX acorn 파서가 backtick 안 ${VAR} 와 <placeholder> 도 JSX 로 파싱 — D-ops-30 decision row 작성 시 2회 build fail.

산출 스크립트: /Users/axe/.axe/vault/invite-members.sh (org member invite 자동), /Users/axe/.axe/vault/deploy-axep.sh (PII push + ship), /Users/axe/.axe/vault/deploy-new-entity.sh (customer-agnostic 일반화), axe vault bootstrap (subcommand).

2026-05-22 — docs.axelabs.ai 검색 + 운영 ritual 4-페이지 분리

docs.axelabs.ai 의 우상단 검색박스가 처음부터 동작 안 했음 (Nextra v4 의 검색이 Pagefind 정적 인덱스 기반인데 빌드 스크립트에 단계 누락). 본일 fix + 라이브 배포 — 4 함정 시리얼 해결: ① Pagefind build 단계 누락 / ② Nextra dev ?metadata 의 acorn 파싱이 backtick 안 <placeholder> 와 ${VAR} 까지 잡는 함정 (17 위치 plain text ASCII 로 정리) / ③ git commit 누락 → 옛 image ship (commit-before-ship ritual) / ④ Cloudflare max-age=14400 옛 404 응답 4시간 캐시 (s-maxage=60 명시로 미래 회피). 검색 라이브 동작 검증: cf-cache-status: HIT, 45 KB.

동시에 운영 흐름의 entry point 가 known-gaps 단일 페이지에 누적되어 다른 세션이 “무엇부터” 가 안 보이던 문제 해소 — 시간축 4-페이지 분리:

• backlog (현재) — 실행 큐 lifecycle 🆕→📋→🔧→✅
• roadmap (미래) — M1~M5 마일스톤 큰 그림
• 본 페이지 (과거) — Ship Log + Highlights + API feed
• known-gaps (사실) — 함정·미해결

또한 본일 후반 /api/changes JSON endpoint 신설 — scripts/generate-changes-json.mjs 가 build 시점 git log → public/changes.json export. cache-control: s-maxage=60 으로 ship 마다 60초 안에 fresh. LLM agent 가 curl https://docs.axelabs.ai/api/changes?since=YYYY-MM-DD 로 변경 fetch 가능. 본 endpoint 도입 중 두 추가 함정 발견: ⑤ node:22-alpine 의 git 바이너리 미포함 (apk add 필요) / ⑥ 같은 macmini 의 compose project 분리 시 container 이름 충돌 (docker rm -f cleanup 필요).

관련 결정: D-docs-search-1, D-docs-roadmap-1, D-docs-updates-1.

2026-05-21 ~ 22 — frame 펀드 도메인 + Blueprint entity·PARA dispatch + hive payroll v2

• frame 펀드 회계 (D-ops-22): shared.entity 에 entity_kind (corporate/kip/kvf) + fund_meta JSONB. AXEV 산하 KIP/KVF 조합 회계 처리 가능. K-IFRS 1110 통제 미달 (운용 관계 — parent-child 아님) 명시
• Blueprint entity 도입 (D-bp-entity-1, PR #339  + #341 ): Workspace 에 entityId FK + paraLayer enum
• PARA dispatch sub-consensus (D-bp-entity-2): copy-with-provenance (sourceWorkspaceId/sourceArtifactPath/copiedAt). UI 는 PR 5 예정
• sys entity 도입 (D-bp-entity-3, PR #344  + #345 ): Workspace.entityId nullable → NOT NULL. ad-hoc / 시스템 row 는 sys entity. General bucket 본질 제거
• hive payroll v2 (D-hive-21 ~ D-hive-26 + D-frame-1): 한국 도메인 본질 7가지 (간이세액표 / 비과세 / 보수월액별 / 부양가족 / 정산 / 일할 / 보험별 라운딩). 분개 trigger = 실 거래 (matching principle) — D-frame-1 의 pending_payroll + match_pending_sweep 흐름
• D-bp-alert-1: Blueprint silent-drop L2 operator alert. AXE-native (Slack 폐기, [OPERATOR-ALERT] 마커 tail → macOS notification)

API feed

LLM agent / 외부 시스템이 시간순 변경 사항을 JSON 으로 받는 endpoint:

GET /api/changes
GET /api/changes?since=2026-05-01
GET /api/changes?limit=20
GET /api/changes?since=2026-05-01&limit=50

응답 (예시):

{
  "site": "https://docs.axelabs.ai",
  "since": "2026-05-01",
  "total": 5,
  "changes": [
    {
      "commit": "49dc3adb",
      "date": "2026-05-22T08:21:48+09:00",
      "subject": "docs(decisions): D-bp-entity-3 — General 제거 + sys entity (#344+#345)",
      "url": "https://docs.axelabs.ai/ops/decisions"
    }
  ]
}

since 는 ISO 8601 또는 YYYY-MM-DD. limit default 30, max 100.

본 endpoint 는 git log 기반 — git log --format=... 을 build 시점이 아닌 request 시점 에 실행. 캐싱 없음 (변경마다 즉시 반영).

LLM 사용 예: 다른 agent 가 자기 컨텍스트 갱신할 때 curl https://docs.axelabs.ai/api/changes?since=$(date -v-7d +%Y-%m-%d) 로 지난 7일 변경 fetch.

운영 ritual

Phase 1 (현재) — 수동

매 axe ship SERVICE 후:

1. 본 페이지의 Ship Log 표에 한 줄 추가
   • 형식: | 2026-MM-DD HH:MM | SERVICE | [SHORT-HASH](url) | COMMIT-SUBJECT |
2. backlog 의 ✅ done 항목 검토 → 의미 있는 것은 본 페이지 Highlights 에 narrative 한 단락
3. 1-2 주에 한 번 — Ship Log 의 의미 있는 항목 묶어서 Highlights 갱신

Phase 2 (계획) — 완전 자동

axe ship 의 post-deploy hook 이:

1. 본 페이지의 Ship Log 표 첫 행에 commit 정보 자동 append
2. backlog 의 🔧 in-progress 중 ship 한 service 의 related 항목을 ✅ done 으로 자동 이동
3. ✅ done 1주 후 본 페이지 Ship Log 로 자동 archive

구현 = B-axe-ship-update-hook (Phase 2).

본 페이지의 의도

backlog 와 roadmap 은 “다음/미래” 의 시점. 본 페이지는 이미 한 일 의 정직 기록. 의도는 3 가지:

• 회고 — “지난 5번 ship 중 어디서 문제 났나” 운영자가 5초 안에
• 공유 — 직원·외부 IT 가 “최근 변경” Highlights 로 narrative 따라가기
• 자동 연동 — LLM agent 가 /api/changes 로 정기 polling