diff --git a/apps/desktop/tests/setup.ts b/apps/desktop/tests/setup.ts index 5cff54f..92536b1 100644 --- a/apps/desktop/tests/setup.ts +++ b/apps/desktop/tests/setup.ts @@ -102,6 +102,23 @@ vi.mock('uiohook-napi', () => ({ }), })) +// nut-js 도 같은 이유로 막는다. 네이티브 libnut 은 X 디스플레이가 없으면 "Could not open +// main display" 를 찍고 워커 프로세스를 죽인다(Linux 러너에서 템플릿 결과 삽입 경로가 실측 +// "Worker exited unexpectedly"). nut-js 동작이 필요한 테스트는 파일에서 다시 vi.mock 한다. +vi.mock('@nut-tree-fork/nut-js', () => ({ + keyboard: { + config: { autoDelayMs: 0 }, + pressKey: vi.fn(async () => undefined), + releaseKey: vi.fn(async () => undefined), + type: vi.fn(async () => undefined), + }, + providerRegistry: { + hasKeyboard: vi.fn(() => false), + getKeyboard: vi.fn(), + }, + Key: new Proxy>({}, { get: (_target, property) => String(property) }), +})) + // WindowManager 모킹 — VoiceModeService가 import하므로 필요 vi.mock('../src/main/windows/WindowManager', () => ({ showRecordingTip: vi.fn(), diff --git a/apps/mobile-rn/__tests__/knowledge-service.test.ts b/apps/mobile-rn/__tests__/knowledge-service.test.ts index 38f790e..9de0d71 100644 --- a/apps/mobile-rn/__tests__/knowledge-service.test.ts +++ b/apps/mobile-rn/__tests__/knowledge-service.test.ts @@ -237,9 +237,11 @@ describe('knowledge edge contracts', () => { // redteam r3-20: 필터가 걸린 postgres_changes 는 DELETE 를 보내지 않고, 필터 없는 DELETE 구독은 남의 행 id 를 흘린다. // 삭제는 knowledge-realtime 의 다른 경로로 받는다 — knowledge-realtime-redteam-r3-20.test.ts 와 같은 계약. - it('subscribes to document inserts and updates through RLS realtime, never to DELETE', () => { - subscribeToKnowledgeDocuments(jest.fn(), jest.fn()) + it('subscribes to document inserts and updates through RLS realtime, never to DELETE', async () => { + const subscription = subscribeToKnowledgeDocuments(jest.fn(), jest.fn()) const events = mockRealtimeOn.mock.calls.map((call) => (call[1] as { event: string }).event) expect(events).toEqual(['INSERT', 'UPDATE']) + // 구독이 삭제 대조용 setInterval 을 켠다. 끄지 않으면 Jest 가 끝나지 않아 CI 잡이 멈춘다. + await subscription.unsubscribe() }) }) diff --git a/docs/map/02-infrastructure.md b/docs/map/02-infrastructure.md index 8a76dcd..cbfc832 100644 --- a/docs/map/02-infrastructure.md +++ b/docs/map/02-infrastructure.md @@ -137,7 +137,11 @@ Stages `validate → test → build → e2e → package → publish → deploy`. ### Forgejo Actions (`.forgejo/workflows/`) `ci.yml` — CI is now Forgejo-only (`.github/workflows` deleted 2026-09-26, Wave 3, dc43884). Jobs: `quality` (`version:check`, `contract:check`, `release:metadata:test`, secret scan, mobile release/config/build-config self-tests, Play asset contract, lint, typecheck, Vitest), `build-validation`, `mobile-quality`, `edge-functions` (Deno), `api-server-tests`. -`payple-renew.yml` — daily cron (+ manual dispatch) → `payple-renew` edge function; ported from the never-run `.github/workflows/payple-renew.yml` because the repository has no GitHub remote. Requires Forgejo secrets `SUPABASE_URL`, `CRON_SECRET`. +`payple-renew.yml` — daily cron (+ manual dispatch) → `payple-renew` edge function; ported from the never-run `.github/workflows/payple-renew.yml` because the repository has no GitHub remote. Requires Forgejo secrets `SUPABASE_URL`, `CRON_SECRET`. 2026-09-26~10-11 `SUPABASE_URL` 시크릿이 로컬 주소(`127.0.0.1:55321`)라 한 번도 성공하지 못했다(GAP-OPS-03). + +**Forgejo 시크릿 정본 = 루트 `.env`.** 웹 UI에서 손으로 넣지 않는다. `.env`를 고친 뒤 `node scripts/ci/set-forgejo-secrets.mjs --check` → `--write [NAME…]`. 스크립트가 Forgejo 시크릿 이름 ↔ `.env` 키 표(SUPABASE_URL, CRON_SECRET, CF_API_TOKEN←CLOUDFLARE_API_TOKEN, CF_ACCOUNT_ID←CLOUDFLARE_ACCOUNT_ID, FORGEJO_TOKEN, WIN_CSC_*)를 갖고, URL 시크릿에 로컬 주소가 있으면 아무것도 쓰지 않는다. + +**러너:** `linux-builder` 라벨은 러너 `kd-desktop` 하나뿐이고, 그 호스트는 노트북 `ChanpacaLaptop`(ssh `vd-linux`, systemd `forgejo-runner.service`, host executor)이다. 노트북이 꺼지면 CI·크론이 전부 멈추고 Forgejo가 대기 잡을 Canceled 처리한다(실측: 2026-09-29 13:24 ~ 10-09 08:30 KST 꺼짐 → run #128~#137 Canceled, `3cac14f` push CI 미실행). GAP-CI-02. `portable.yml` — 태그/수동 실행으로 **서명 없이** portable 채널(95MiB 7z 분할 볼륨 + Scoop 매니페스트 + 설치 스크립트)을 게시한다. `WIN_CSC_*` 불필요, updater feed는 건드리지 않는다. diff --git a/docs/map/11-gap-backlog.md b/docs/map/11-gap-backlog.md index 5dd05a6..5c4c3fc 100644 --- a/docs/map/11-gap-backlog.md +++ b/docs/map/11-gap-backlog.md @@ -32,6 +32,9 @@ Legend: `[ ]` open · `[~]` in progress · `[!]` blocked externally · `[x]` res | GAP-WEB-01 | Web | 웹앱(`apps/web`)이 공개되지 않았다(배포 경로가 없었음). | `apps/web/Dockerfile`, `docker-compose.nas.yml`, `server/cloudflare-site-bridge` | `[x]` 2026-09-26: `/app` basePath·NAS `d3ro_voice_web`(3002). 터널 `kd-nas` ingress에 `d3ro.chanpaca.net` path `^/app` → NAS 3002를 추가하고 브리지 워커가 `/app`·`/api`·`/health`를 도메인 원본(터널)으로 흘린다(4aadee8). Supabase `site_url`을 `https://d3ro.chanpaca.net/app`으로(기존 localhost:3000), 허용 목록에 `/app/**` 추가. 라이브 `/app/login` 200. 같은 수정으로 9/19부터 끊겨 있던 API(`/api`, 관리자 로그인·stt-proxy)도 복구. | | GAP-OPS-01 | Ops | NAS 운영 compose가 저장소와 어긋나 있었다(JWT 기본값 폴백, 법률 wwwroot 마운트, 필수 변수 4개 누락). | `docker-compose.nas.yml`, NAS `/volume1/docker/d3ro/.env` | `[x]` 2026-09-26: NAS `.env`에 `SUPABASE_URL`·`SUPABASE_SERVICE_ROLE_KEY`(운영 service_role)·`ADMIN_BOOTSTRAP_TOKEN`(신규)·`API_SERVER_URL` 추가, 저장소 compose로 교체 후 `docker compose up -d`. 4개 컨테이너 정상, 백업 `*.before-wave3-20260926`. | | GAP-OPS-02 | Ops | 관리자 주소가 두 개였다(`admin.chanpaca.net`, `d3ro-admin.chanpaca.net`). `admin.d3ro.chanpaca.net`은 2단계 서브도메인이라 고급 인증서(ACM, 월 $10)가 필요하다. | Cloudflare 터널 kd-nas ingress, chanpaca.net DNS | `[x]` 2026-09-26: 사용자 결정 — 관리자 주소는 `d3ro-admin.chanpaca.net` 하나(chanpaca.net에 다른 서비스가 많다). `admin.chanpaca.net` 터널 규칙·DNS 삭제로 이름을 풀었다. ACM은 지금 구독하지 않는다. 참고: `*.kite`·`*.voice` 고급 인증서는 ACM이 꺼져 2026-11-02 만료 후 갱신되지 않는다(다른 프로젝트). | +| GAP-OPS-03 | Ops | **`payple-renew` 크론이 등록 이후 한 번도 성공하지 못했다.** Forgejo 시크릿 `SUPABASE_URL`이 로컬 Supabase 주소(`127.0.0.1:55321`)로 등록돼 매일 `curl: (7) Failed to connect`. Payple 계약 전이라 청구 대상 구독은 없다(GAP-BILL-02). | `.forgejo/workflows/payple-renew.yml`, `scripts/ci/set-forgejo-secrets.mjs` | `[~]` 2026-10-11: 시크릿을 `.env` 운영 값으로 교체, 스크립트를 `.env` 정본 동기화 + 로컬 주소 거부로 확장. 남은 확인: 다음 정기 실행(10:00 KST)이 HTTP 200인지(수동 dispatch는 실결제 경로라 보류). | +| GAP-CI-02 | CI | `linux-builder` 러너가 노트북 한 대(`kd-desktop`)뿐이라 노트북이 꺼지면 CI·크론이 통째로 멈춘다(2026-09-29~10-09, run #128~#137 Canceled). | `.forgejo/workflows/*.yml` (`runs-on: linux-builder`) | `[ ]` 후보: 상시 켜진 NAS 러너에 `linux-builder`(또는 크론 전용) 라벨 추가, 최소한 `payple-renew`는 NAS로. | +| GAP-CI-03 | CI | 9-28부터 `ci.yml`의 데스크톱 Vitest·모바일 Jest가 테스트 전부 통과인데도 실패했다. 데스크톱: 템플릿 테스트가 결과를 실제 TextInsertService로 넣다가 nut-js(libnut)가 X 디스플레이 없음(`Could not open main display`)으로 워커를 죽임. 모바일: `knowledge-service.test.ts`가 구독의 삭제 대조 setInterval을 끄지 않아 Jest가 끝나지 않음(잡 무한 대기). | `apps/desktop/tests/setup.ts`, `apps/mobile-rn/__tests__/knowledge-service.test.ts` | `[x]` 2026-10-11: setup.ts에 nut-js 공통 목, 테스트가 unsubscribe. 러너 호스트(vd-linux)에서 데스크톱 2539/2539 exit 0, 모바일 589/589 정상 종료 확인. | | GAP-CI-01 | CI | macOS 빌드·서명 러너가 없다. `.github`의 build-mac·release-signing-ca는 실행된 적 없이 삭제됐다. | `.forgejo/workflows/*`, `.gitlab-ci.yml` | `[!]` EXT: Mac 호스트에 Forgejo runner(`macos` 라벨)를 붙이거나 GitLab `package-macos` 사용. 서명된 Android 릴리스는 GitLab `mobile-production-release`가 정본. | | GAP-I18N-02 | Desktop | 녹음 캡슐의 "처리 중..."이 `recording-tip/index.html`에 한국어로 고정돼 앱 언어를 따르지 않는다. | `apps/desktop/src/renderer/popups/recording-tip/*`, `WindowManager.getPopupI18nStrings` | `[x]` 2026-09-28: 캡슐 문구는 main `_i18n`(popup.tip.*)으로, 오류는 `@d3ro/core/voice-error-message` 분류 → 사용자 언어 문구(bootstrap 이 error.code 를 넘기지 않던 버그 포함). 팝업 문서 lang 도 앱 언어. | | GAP-UX-01 | Desktop | 회의 "내 메모"(상세 탭)는 이 기기 localStorage 에만 저장된다 — 기기 간 동기화되지 않는다. 끝난 회의에는 addMemo 가 거부된다(`MeetingModeService.ts:383`). | `components/meeting/meeting-notepad-storage.ts`, `MeetingModeService` | `[ ]` 2026-09-28: 끝난 회의의 사용자 노트를 받을 필드(또는 종료 후 addMemo)와 동기화 어댑터가 필요. | diff --git a/scripts/ci/set-forgejo-secrets.mjs b/scripts/ci/set-forgejo-secrets.mjs index 4631918..b33e8b6 100644 --- a/scripts/ci/set-forgejo-secrets.mjs +++ b/scripts/ci/set-forgejo-secrets.mjs @@ -1,13 +1,18 @@ // scripts/ci/set-forgejo-secrets.mjs -// Forgejo Actions 저장소 시크릿을 점검하거나 등록한다. +// Forgejo Actions 저장소 시크릿을 루트 .env 기준으로 점검하거나 맞춘다. // -// 배경: 데스크톱 릴리스 워크플로(.forgejo/workflows/release.yml)는 아래 시크릿이 -// 없으면 fail-closed로 중단한다. 저장소에 시크릿이 하나도 없으면 태그를 올려도 -// 설치본이 게시되지 않는다(실측: run 49/51 모두 서명 가드에서 실패). +// 원칙: 시크릿 값의 정본은 루트 .env 다. Forgejo 웹 UI 에서 손으로 넣지 말고 +// .env 를 고친 뒤 --write 로 밀어 넣는다. Forgejo API 는 값을 돌려주지 않으므로 +// --write 는 .env 에 값이 있는 시크릿을 항상 덮어쓴다. +// +// 배경: 2026-09-26 SUPABASE_URL 시크릿에 로컬 Supabase 주소(127.0.0.1:55321)가 +// 들어가 payple-renew 크론이 한 번도 성공하지 못했다. 그래서 운영 시크릿에는 +// 로컬 주소를 거부하는 검사를 둔다. // // 사용: -// node scripts/ci/set-forgejo-secrets.mjs --check # 현재 상태만 확인 -// node --env-file-if-exists=.env scripts/ci/set-forgejo-secrets.mjs --write +// node scripts/ci/set-forgejo-secrets.mjs --check # 등록 여부 + .env 값 검사 +// node scripts/ci/set-forgejo-secrets.mjs --write # .env 값으로 등록/덮어쓰기 +// node scripts/ci/set-forgejo-secrets.mjs --write SUPABASE_URL CRON_SECRET # 일부만 // // 값은 출력하지 않는다(이름/존재 여부/길이만). FORGEJO_TOKEN(쓰기 스코프 필요)은 // .env 또는 환경변수에서 읽는다. @@ -16,18 +21,26 @@ import { readFileSync, existsSync } from 'node:fs' import { dirname, join } from 'node:path' import { fileURLToPath } from 'node:url' -const REQUIRED = [ - 'WIN_CSC_LINK', - 'WIN_CSC_KEY_PASSWORD', - 'WIN_CSC_EXPECTED_SIGNER_SUBJECT', - 'FORGEJO_TOKEN', +// Forgejo 시크릿 이름 → .env 키. required=false 는 값이 없으면 건너뛴다. +const SECRETS = [ + { name: 'SUPABASE_URL', envKey: 'SUPABASE_URL', required: true, url: true, usedBy: 'payple-renew.yml' }, + { name: 'CRON_SECRET', envKey: 'CRON_SECRET', required: true, usedBy: 'payple-renew.yml' }, + { name: 'CF_API_TOKEN', envKey: 'CLOUDFLARE_API_TOKEN', required: true, usedBy: 'deploy-site.yml' }, + { name: 'CF_ACCOUNT_ID', envKey: 'CLOUDFLARE_ACCOUNT_ID', required: true, usedBy: 'deploy-site.yml' }, + { name: 'FORGEJO_TOKEN', envKey: 'FORGEJO_TOKEN', required: true, usedBy: 'release.yml, portable.yml' }, + { name: 'WIN_CSC_LINK', envKey: 'WIN_CSC_LINK', required: false, usedBy: 'release.yml' }, + { name: 'WIN_CSC_KEY_PASSWORD', envKey: 'WIN_CSC_KEY_PASSWORD', required: false, usedBy: 'release.yml' }, + { name: 'WIN_CSC_EXPECTED_SIGNER_SUBJECT', envKey: 'WIN_CSC_EXPECTED_SIGNER_SUBJECT', required: false, usedBy: 'release.yml' }, ] +const LOCAL_HOST = /^(https?:\/\/)?(localhost|127\.|0\.0\.0\.0|\[::1\]|host\.docker\.internal)/i + const root = join(dirname(fileURLToPath(import.meta.url)), '..', '..') const args = process.argv.slice(2) const write = args.includes('--write') +const only = args.filter((arg) => !arg.startsWith('--')) -/** .env(있으면) + 환경변수에서 값 조회. 값은 로그에 절대 남기지 않는다. */ +/** .env(있으면) + 환경변수에서 값 조회. .env 가 우선이다(정본). 값은 로그에 남기지 않는다. */ function readEnv() { const values = { ...process.env } const envPath = join(root, '.env') @@ -35,14 +48,23 @@ function readEnv() { for (const line of readFileSync(envPath, 'utf8').split(/\r?\n/)) { if (!/^[A-Z0-9_]+=/.test(line)) continue const index = line.indexOf('=') - const key = line.slice(0, index) - if (values[key]) continue - values[key] = line.slice(index + 1).trim() + const value = line.slice(index + 1).trim().replace(/^(['"])(.*)\1$/, '$2') + if (value) values[line.slice(0, index)] = value } } return values } +/** 값이 운영 시크릿으로 쓸 수 있는지. 문제가 있으면 이유를, 없으면 null. */ +function validate(spec, value) { + if (!value) return spec.required ? '.env 에 값 없음' : null + if (spec.url) { + if (LOCAL_HOST.test(value)) return '로컬 주소는 운영 시크릿이 될 수 없음' + if (!/^https:\/\/[^/]+$/.test(value.replace(/\/$/, ''))) return 'https:// 형식이어야 함' + } + return null +} + const env = readEnv() const token = env.FORGEJO_TOKEN?.trim() const server = (env.GIT_SERVER_URL?.trim() || 'https://git.chanpaca.net').replace(/\/$/, '') @@ -72,60 +94,51 @@ async function putSecret(name, value) { headers: { ...headers, 'Content-Type': 'application/json' }, body: JSON.stringify({ data: value }), }) - if (!response.ok && response.status !== 201 && response.status !== 204) { + if (!response.ok) { throw new Error(`${name} 등록 실패: HTTP ${response.status}`) } } -const existing = await listSecrets() -console.log(`저장소: ${owner}/${repo} (${server})`) -console.log(`시크릿 API: ${apiBase}\n`) - -let missing = 0 -for (const name of REQUIRED) { - const present = existing.has(name) - if (present) { - console.log(` [x] ${name} — 등록됨`) - continue - } - missing += 1 - const value = env[name]?.trim() - console.log(` [ ] ${name} — 없음${value ? ` (환경/.env에 값 있음, 길이 ${value.length})` : ' (값 없음)'}`) +const unknown = only.filter((name) => !SECRETS.some((spec) => spec.name === name)) +if (unknown.length) { + console.error(`알 수 없는 시크릿: ${unknown.join(', ')}`) + process.exit(1) } +const targets = only.length ? SECRETS.filter((spec) => only.includes(spec.name)) : SECRETS -if (missing === 0) { - console.log('\n모든 릴리스 시크릿이 준비되었습니다.') - process.exit(0) +const existing = await listSecrets() +console.log(`저장소: ${owner}/${repo} (${server})\n`) + +let problems = 0 +for (const spec of targets) { + const value = env[spec.envKey]?.trim() + const issue = validate(spec, value) + const registered = existing.has(spec.name) ? '등록됨' : '없음' + const source = value ? `.env ${spec.envKey} 길이 ${value.length}` : `.env ${spec.envKey} 없음` + if (issue && (spec.required || value)) problems += 1 + console.log(` [${issue ? '!' : 'x'}] ${spec.name} — ${registered}, ${source}${issue ? ` — ${issue}` : ''} (${spec.usedBy})`) } if (!write) { - console.log( - [ - `\n누락 ${missing}건. 값이 준비되면 다음으로 등록한다:`, - ' node --env-file-if-exists=.env scripts/ci/set-forgejo-secrets.mjs --write', - '', - 'WIN_CSC_LINK는 public-trust Authenticode PFX를 base64로 인코딩한 값이어야 하며,', - 'WIN_CSC_EXPECTED_SIGNER_SUBJECT는 그 인증서의 정확한 subject 문자열이어야 한다.', - '(개발용 Everything2EverythingDev 인증서는 production으로 인정되지 않는다.)', - ].join('\n'), - ) - process.exit(missing === 0 ? 0 : 2) + console.log(problems ? `\n문제 ${problems}건.` : '\n.env 값 검사 통과. --write 로 Forgejo 에 반영한다.') + process.exit(problems ? 2 : 0) +} + +if (problems) { + console.error('\n.env 값에 문제가 있어 아무것도 쓰지 않았다. .env 를 고친 뒤 다시 실행한다.') + process.exit(2) } let written = 0 -for (const name of REQUIRED) { - if (existing.has(name)) continue - const value = env[name]?.trim() - if (!value) { - console.log(` 건너뜀: ${name} (값 없음)`) - continue - } - await putSecret(name, value) +for (const spec of targets) { + const value = env[spec.envKey]?.trim() + if (!value) continue + await putSecret(spec.name, value) written += 1 - console.log(` 등록: ${name}`) + console.log(` 반영: ${spec.name}`) } const after = await listSecrets() -const stillMissing = REQUIRED.filter((name) => !after.has(name)) -console.log(`\n등록 ${written}건. 남은 누락: ${stillMissing.length ? stillMissing.join(', ') : '없음'}`) -process.exit(stillMissing.length === 0 ? 0 : 2) \ No newline at end of file +const stillMissing = targets.filter((spec) => spec.required && !after.has(spec.name)).map((spec) => spec.name) +console.log(`\n반영 ${written}건. 남은 누락: ${stillMissing.length ? stillMissing.join(', ') : '없음'}`) +process.exit(stillMissing.length === 0 ? 0 : 2)