feat(commands): multi-select ordered command pipeline with step reordering and single-pass composition (AI-05, AI-07)

This commit is contained in:
Yun Chan 2026-10-31 02:54:54 +09:00
parent f49acf0105
commit 10af20a0ad
157 changed files with 29455 additions and 913 deletions

View file

@ -0,0 +1,121 @@
// scripts/ci/check-supabase-migrations.mjs
// Supabase 마이그레이션 파일 정합성 검증 (GAP-OPS-01).
//
// 검증 항목:
// 1) server/supabase/migrations 내 모든 파일이 `<14자리 타임스탬프>_<snake_case>.sql` 형식인지
// 2) 타임스탬프 접두사가 중복되지 않는지
// 3) 파일 목록(사전순)에서 타임스탬프가 엄격히 단조 증가하는지
// 4) 각 SQL 파일이 비어 있지 않은지
import { readdirSync, readFileSync, statSync } from 'node:fs'
import { dirname, join } from 'node:path'
import { fileURLToPath } from 'node:url'
const root = join(dirname(fileURLToPath(import.meta.url)), '..', '..')
const migrationsDir = join(root, 'server', 'supabase', 'migrations')
const MIGRATION_PATTERN = /^(\d{14})_([a-z0-9]+(?:_[a-z0-9]+)*)\.sql$/
export function validateMigrationFiles(entries) {
const errors = []
if (!Array.isArray(entries) || entries.length === 0) {
errors.push('no_migration_files_found')
return { ok: false, count: 0, errors }
}
const seenTimestamps = new Map()
let previousTimestamp = null
let previousFile = null
for (const entry of entries) {
const { name, size } = entry
const match = MIGRATION_PATTERN.exec(name)
if (!match) {
errors.push(`invalid_migration_filename:${name}`)
continue
}
const timestamp = match[1]
if (seenTimestamps.has(timestamp)) {
errors.push(`duplicate_migration_timestamp:${timestamp}:${seenTimestamps.get(timestamp)}:${name}`)
} else {
seenTimestamps.set(timestamp, name)
}
if (previousTimestamp !== null && BigInt(timestamp) <= BigInt(previousTimestamp)) {
errors.push(`non_monotonic_migration_timestamp:${previousFile}->${name}`)
}
if (typeof size === 'number' && size <= 0) {
errors.push(`empty_migration_file:${name}`)
}
previousTimestamp = timestamp
previousFile = name
}
return {
ok: errors.length === 0,
count: entries.length,
first: entries[0]?.name ?? null,
last: entries[entries.length - 1]?.name ?? null,
errors,
}
}
function loadActualEntries() {
const names = readdirSync(migrationsDir).sort((a, b) => a.localeCompare(b))
return names.map((name) => {
const fullPath = join(migrationsDir, name)
const stat = statSync(fullPath)
const content = stat.isFile() ? readFileSync(fullPath, 'utf8').trim() : ''
return {
name,
size: content.length,
}
})
}
const actual = validateMigrationFiles(loadActualEntries())
if (!actual.ok) {
throw new Error(`supabase_migrations_invalid:${actual.errors.join(',')}`)
}
if (process.argv.includes('--self-test')) {
const validSample = [
{ name: '20260409000001_initial_schema.sql', size: 120 },
{ name: '20260409000002_rls_policies.sql', size: 85 },
]
if (!validateMigrationFiles(validSample).ok) {
throw new Error('check_supabase_migrations_self_test_failed:valid_sample_rejected')
}
const dupSample = [
{ name: '20260409000001_initial_schema.sql', size: 120 },
{ name: '20260409000001_duplicate_prefix.sql', size: 85 },
]
const dupRes = validateMigrationFiles(dupSample)
if (dupRes.ok || !dupRes.errors.some((e) => e.startsWith('duplicate_migration_timestamp:'))) {
throw new Error('check_supabase_migrations_self_test_failed:duplicate_not_caught')
}
const badNameSample = [
{ name: '20260409_short_ts.sql', size: 100 },
]
const badNameRes = validateMigrationFiles(badNameSample)
if (badNameRes.ok || !badNameRes.errors.some((e) => e.startsWith('invalid_migration_filename:'))) {
throw new Error('check_supabase_migrations_self_test_failed:invalid_name_not_caught')
}
const emptySample = [
{ name: '20260409000001_empty.sql', size: 0 },
]
const emptyRes = validateMigrationFiles(emptySample)
if (emptyRes.ok || !emptyRes.errors.some((e) => e.startsWith('empty_migration_file:'))) {
throw new Error('check_supabase_migrations_self_test_failed:empty_not_caught')
}
actual.selfTest = 'passed'
}
process.stdout.write(`${JSON.stringify(actual, null, 2)}\n`)

View file

@ -22,10 +22,11 @@ import { fileURLToPath } from 'node:url'
const root = join(dirname(fileURLToPath(import.meta.url)), '..', '..')
const inPlace = process.argv.includes('--in-place')
const dirFlagIndex = process.argv.indexOf('--dir')
const packagedDir = dirFlagIndex >= 0 ? process.argv[dirFlagIndex + 1] : null
if (!packagedDir || !existsSync(packagedDir)) {
console.error('사용: node scripts/ci/fix-native-abi.mjs --dir <packagedDir>')
if (!inPlace && (!packagedDir || !existsSync(packagedDir))) {
console.error('사용: node scripts/ci/fix-native-abi.mjs --dir <packagedDir> | --in-place')
process.exit(1)
}
@ -43,7 +44,9 @@ const relativeBinary = join(
'Release',
'better_sqlite3.node',
)
const targetBinary = join(packagedDir, 'resources', 'app.asar.unpacked', relativeBinary)
const targetBinary = inPlace
? join(root, relativeBinary)
: join(packagedDir, 'resources', 'app.asar.unpacked', relativeBinary)
if (!existsSync(targetBinary)) {
console.error(`[native-abi] 패키징 트리에 better-sqlite3 바이너리가 없습니다: ${targetBinary}`)

View file

@ -21,6 +21,7 @@
// 선택: FORGEJO_RELEASE_TAG (기본: CI_COMMIT_TAG/GITHUB_REF_NAME/FORGEJO_REF_NAME)
// 선택: FORGEJO_PUBLISH_DRY_RUN=1 (업로드 없이 사전점검)
import { spawnSync } from "node:child_process";
import { createHash } from "node:crypto";
import { createReadStream, readFileSync } from "node:fs";
import { readFile, readdir, stat, writeFile } from "node:fs/promises";
@ -423,14 +424,48 @@ function extractChangelogSection(changelog, targetVersion) {
return lines.slice(start, end).join("\n").trim();
}
function resolveTargetCommitish(releaseTag) {
const fromEnv =
process.env.FORGEJO_TARGET_COMMITISH?.trim() ||
process.env.CI_COMMIT_SHA?.trim() ||
process.env.GITHUB_SHA?.trim();
if (fromEnv && /^[0-9a-f]{40}$/i.test(fromEnv)) return fromEnv;
const repoRoot = fileURLToPath(new URL("../..", import.meta.url));
const resolved = spawnSync("git", ["rev-parse", `${releaseTag}^{commit}`], {
cwd: repoRoot,
encoding: "utf8",
});
const sha = (resolved.stdout ?? "").trim();
if (resolved.status === 0 && /^[0-9a-f]{40}$/i.test(sha)) return sha;
const head = spawnSync("git", ["rev-parse", "HEAD"], {
cwd: repoRoot,
encoding: "utf8",
});
const headSha = (head.stdout ?? "").trim();
if (head.status === 0 && /^[0-9a-f]{40}$/i.test(headSha)) return headSha;
throw new Error(
`Cannot resolve commit SHA for ${releaseTag}; push the annotated tag first or set FORGEJO_TARGET_COMMITISH.`,
);
}
async function upsertRelease(description) {
const targetCommitish = resolveTargetCommitish(tag);
const byTag = await forgejoFetch(`${releasesApiUrl}/tags/${encodeURIComponent(tag)}`);
if (byTag.ok) {
const existing = await byTag.json();
const update = await forgejoFetch(`${releasesApiUrl}/${existing.id}`, {
method: "PATCH",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ name: `D3RO Voice ${tag}`, body: description, prerelease: false, draft: false }),
body: JSON.stringify({
target_commitish: targetCommitish,
name: `D3RO Voice ${tag}`,
body: description,
prerelease: false,
draft: false,
}),
});
if (!update.ok) throw new Error(`release update failed: HTTP ${update.status} ${await update.text()}`);
return existing.id;
@ -439,12 +474,22 @@ async function upsertRelease(description) {
throw new Error(`release lookup failed: HTTP ${byTag.status} ${await byTag.text()}`);
}
// Forgejo POST /releases 는 원격에 태그가 아직 없으면 target_commitish 에 lightweight 태그를 새로 만든다.
// 로컬 annotated 태그 푸시가 나중에 'already exists' 로 거절되지 않도록 원격 태그 존재를 먼저 확인한다(GAP-REL-14).
const tagRefUrl = `${origin}/api/v1/repos/${owner}/${repo}/git/refs/tags/${encodeURIComponent(tag)}`;
const tagRefRes = await forgejoFetch(tagRefUrl);
if (tagRefRes.status === 404) {
throw new Error(
`Remote tag ${tag} does not exist on Forgejo yet. Push main and ${tag} before creating the Forgejo release.`,
);
}
const create = await forgejoFetch(releasesApiUrl, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
tag_name: tag,
target_commitish: "main",
target_commitish: targetCommitish,
name: `D3RO Voice ${tag}`,
body: description,
draft: false,

View file

@ -11,10 +11,10 @@
// 1. 점검 main 브랜치 · 깨끗한 작업 트리 · Forgejo 토큰 · 서명 키 짝 · 태그 미사용
// 2. 버전 product-version.json + sync-version --write + CHANGELOG 섹션(없으면 커밋 제목으로 초안)
// 3. 게이트 typecheck · version:check · release:metadata
// 4. 커밋 + annotated 태그 (로컬만 — 게시가 끝나야 푸시한다)
// 4. 커밋 + annotated 태그 (로컬 생성)
// 5. 빌드 build-desktop-installer.mjs
// 6. 게시 publish-forgejo-release.mjs (latest.yml Ed25519 서명 · 불변 버전 경로 · latest 피드 · 공개 URL 재검증)
// 7. 푸시 chanpaca main + 태그 (origin 미러는 실패해도 경고만)
// 6. 푸시 chanpaca main + annotated 태그 (Forgejo Release 가 옛 main 에 가짜 태그를 만들지 않도록 게시 전에 푸시)
// 7. 게시 publish-forgejo-release.mjs (latest.yml Ed25519 서명 · 불변 버전 경로 · latest 피드 · 공개 URL 재검증)
//
// 태그는 불변이다. 게시된 버전에 문제가 있으면 더 높은 patch 로 다시 낸다.
@ -80,7 +80,7 @@ if (resume) {
const notes = changelog.includes(`## [${version}] - `) ? null : draftNotes(current.version)
if (dryRun) {
info(notes ? `CHANGELOG 초안:\n${notes}` : 'CHANGELOG 섹션 있음')
info('단계: 커밋·태그 → 빌드 → 게시(서명) → 공개 URL 검증 → 푸시')
info('단계: 커밋·태그 → 빌드 → 푸시 → 게시(서명) → 공개 URL 검증')
info('dry-run — 아무것도 바꾸지 않았습니다.')
process.exit(0)
}
@ -115,6 +115,7 @@ if (resume) {
}
const tag = `v${version}`
const tagCommit = git(['rev-parse', `${tag}^{commit}`])
// 태그가 생긴 뒤의 실패는 --resume 으로 이어 간다.
const resumeHint = '\n고친 뒤 이어 가기: npm run release -- --resume'
@ -122,24 +123,26 @@ const resumeHint = '\n고친 뒤 이어 가기: npm run release -- --resume'
// 이미 게시가 끝난 버전을 다시 빌드하면 바이트가 달라 불변 경로와 충돌한다 — 푸시만 남은 경우다.
if (resume && (await feedHasVersion(version))) {
info(`피드에 ${version} 가 이미 있습니다 — 빌드·게시를 건너뜁니다.`)
pushToRemotes(tag, tagCommit)
} else {
// ── 5. 빌드 ──
step('빌드')
runNode('scripts/ci/build-desktop-installer.mjs', [], {}, resumeHint)
// ── 6. 게시 ──
step('게시')
runNode('scripts/ci/publish-forgejo-release.mjs', [], { FORGEJO_RELEASE_TAG: tag }, resumeHint)
}
// ── 6. 푸시 ──
// Forgejo Release 생성 API(POST /releases)는 원격에 태그가 아직 없으면 target_commitish 에
// lightweight 태그를 만들어 버려 뒤이은 annotated 태그 푸시가 'already exists' 로 실패한다(GAP-REL-14).
// 따라서 게시 전에 main 과 annotated 태그를 먼저 정본 원격(chanpaca)에 푸시한다.
pushToRemotes(tag, tagCommit)
// ── 7. 푸시 ──
step('푸시')
// 게시는 끝났다 — 푸시 실패는 사용자 업데이트에 영향이 없고, 손으로 다시 밀면 된다.
const pushed = spawnSync('git', ['push', CANONICAL_REMOTE, 'main', tag], { cwd: root, stdio: 'inherit' })
if (pushed.status !== 0) warn(`${CANONICAL_REMOTE} 푸시 실패 — git push ${CANONICAL_REMOTE} main ${tag}`)
for (const remote of MIRROR_REMOTES) {
const result = spawnSync('git', ['push', remote, 'main', tag], { cwd: root, stdio: 'inherit' })
if (result.status !== 0) warn(`${remote} 미러 푸시 실패 — 나중에 git push ${remote} main ${tag}`)
// ── 7. 게시 ──
step('게시')
runNode(
'scripts/ci/publish-forgejo-release.mjs',
[],
{ FORGEJO_RELEASE_TAG: tag, FORGEJO_TARGET_COMMITISH: tagCommit },
resumeHint,
)
}
step('완료')
@ -148,6 +151,26 @@ info(`피드: ${FEED}/latest/latest.yml`)
// ── helpers ──
function pushToRemotes(releaseTag, expectedCommit) {
step('푸시')
const pushed = spawnSync('git', ['push', CANONICAL_REMOTE, 'main', releaseTag], { cwd: root, stdio: 'inherit' })
if (pushed.status !== 0) {
fail(`${CANONICAL_REMOTE} 푸시 실패 — git push ${CANONICAL_REMOTE} main ${releaseTag}${resumeHint}`)
}
const deref = git(['ls-remote', CANONICAL_REMOTE, `refs/tags/${releaseTag}^{}`]).split(/\s+/)[0]
const direct = git(['ls-remote', CANONICAL_REMOTE, `refs/tags/${releaseTag}`]).split(/\s+/)[0]
const remoteCommit = deref || direct
if (remoteCommit && remoteCommit !== expectedCommit) {
fail(
`${CANONICAL_REMOTE} 의 ${releaseTag} 태그 커밋(${remoteCommit})이 로컬(${expectedCommit})과 다릅니다.`,
)
}
for (const remote of MIRROR_REMOTES) {
const result = spawnSync('git', ['push', remote, 'main', releaseTag], { cwd: root, stdio: 'inherit' })
if (result.status !== 0) warn(`${remote} 미러 푸시 실패 — 나중에 git push ${remote} main ${releaseTag}`)
}
}
function nextVersion(from, bump) {
const [major, minor, patch] = from.split('.').map(Number)
if (bump === 'patch') return `${major}.${minor}.${patch + 1}`

View file

@ -0,0 +1,112 @@
#!/usr/bin/env node
// scripts/ci/sync-i18n-locales.mjs
// Synchronizes translation keys across all 12 locale files in packages/i18n/src/locales/*.json.
// Master key list is the union of ko.json and en.json (ordered by ko.json).
import fs from 'node:fs'
import path from 'node:path'
import { fileURLToPath } from 'node:url'
const __dirname = path.dirname(fileURLToPath(import.meta.url))
const localesDir = path.resolve(__dirname, '../../packages/i18n/src/locales')
const koPath = path.join(localesDir, 'ko.json')
const enPath = path.join(localesDir, 'en.json')
const ko = JSON.parse(fs.readFileSync(koPath, 'utf8'))
const en = JSON.parse(fs.readFileSync(enPath, 'utf8'))
// GAP-UX-07: Align onboarding.llmModelSize with OllamaGuideModal (gemma4:e4b = ~4.0 GB)
ko['onboarding.llmModelSize'] = '크기: 약 4.0GB — 네트워크 속도에 따라 3~10분 소요'
en['onboarding.llmModelSize'] = 'Size: ~4.0GB — takes 3–10 min depending on network speed'
// Missing login.* keys in en.json
const enLoginDefaults = {
'login.apple': 'Continue with Apple',
'login.or': 'or',
'login.email': 'Email',
'login.password': 'Password',
'login.signIn': 'Sign in',
'login.noAccount': "Don't have an account?",
'login.signUp': 'Sign up',
}
for (const [k, v] of Object.entries(enLoginDefaults)) {
if (!(k in en)) en[k] = v
}
// GAP-LLM-01: Translation target language setting keys
const targetLangKo = {
'settings.targetLanguage': '번역 대상 언어',
'settings.targetLanguage.desc': '번역 후처리와 {{targetLanguage}} 명령어에 쓸 언어입니다.',
'settings.targetLanguage.en': '영어 (English)',
'settings.targetLanguage.ko': '한국어 (Korean)',
'settings.targetLanguage.ja': '일본어 (Japanese)',
'settings.targetLanguage.zhCN': '중국어 간체 (Chinese Simplified)',
'settings.targetLanguage.zhTW': '중국어 번체 (Chinese Traditional)',
'settings.targetLanguage.es': '스페인어 (Spanish)',
'settings.targetLanguage.fr': '프랑스어 (French)',
'settings.targetLanguage.de': '독일어 (German)',
'settings.targetLanguage.pt': '포르투갈어 (Portuguese)',
'settings.targetLanguage.vi': '베트남어 (Vietnamese)',
'settings.targetLanguage.id': '인도네시아어 (Indonesian)',
'settings.targetLanguage.ar': '아랍어 (Arabic)',
}
const targetLangEn = {
'settings.targetLanguage': 'Translation target language',
'settings.targetLanguage.desc': 'Language used for translation post-processing and {{targetLanguage}} commands.',
'settings.targetLanguage.en': 'English',
'settings.targetLanguage.ko': 'Korean',
'settings.targetLanguage.ja': 'Japanese',
'settings.targetLanguage.zhCN': 'Chinese (Simplified)',
'settings.targetLanguage.zhTW': 'Chinese (Traditional)',
'settings.targetLanguage.es': 'Spanish',
'settings.targetLanguage.fr': 'French',
'settings.targetLanguage.de': 'German',
'settings.targetLanguage.pt': 'Portuguese',
'settings.targetLanguage.vi': 'Vietnamese',
'settings.targetLanguage.id': 'Indonesian',
'settings.targetLanguage.ar': 'Arabic',
}
Object.assign(ko, targetLangKo)
Object.assign(en, targetLangEn)
// Ensure ko and en have identical key sets
for (const k of Object.keys(ko)) {
if (!(k in en)) {
en[k] = ko[k]
}
}
for (const k of Object.keys(en)) {
if (!(k in ko)) {
ko[k] = en[k]
}
}
const masterKeys = Object.keys(ko)
function writeOrderedJson(filePath, obj) {
const ordered = {}
for (const k of masterKeys) {
ordered[k] = obj[k]
}
fs.writeFileSync(filePath, JSON.stringify(ordered, null, 2) + '\n', 'utf8')
}
writeOrderedJson(koPath, ko)
writeOrderedJson(enPath, en)
const otherLocales = ['ja', 'zh', 'zh-TW', 'es', 'fr', 'de', 'pt', 'ru', 'vi', 'th']
for (const loc of otherLocales) {
const locPath = path.join(localesDir, `${loc}.json`)
const data = JSON.parse(fs.readFileSync(locPath, 'utf8'))
for (const k of masterKeys) {
if (!(k in data) || typeof data[k] !== 'string' || data[k].length === 0) {
data[k] = en[k] ?? ko[k]
}
}
writeOrderedJson(locPath, data)
}
console.log(`Synchronized ${masterKeys.length} keys across 12 locales.`)

View file

@ -34,6 +34,7 @@ function loadSurfaces(readSurface = read) {
forgejoPublisher: readSurface('scripts/ci/publish-forgejo-release.mjs'),
gitlab: readSurface('.gitlab-ci.yml'),
forgejoRelease: readSurface('.forgejo/workflows/release.yml'),
forgejoPortable: readSurface('.forgejo/workflows/portable.yml'),
changelog: readSurface('CHANGELOG.md'),
}
}
@ -224,6 +225,24 @@ function validate(surfaces) {
surfaces.forgejoPublisher.includes('generic'),
'forgejo_publisher_registry_path_missing',
)
// GAP-REL-14: Forgejo Release 가 옛 main 커밋에 가짜 lightweight 태그를 만들지 않도록
// 정확한 커밋 SHA(resolveTargetCommitish)를 쓰고 게시 전에 태그를 먼저 푸시한다.
fail(
!surfaces.forgejoPublisher.includes('target_commitish: "main"') &&
surfaces.forgejoPublisher.includes('resolveTargetCommitish('),
'forgejo_publisher_mutable_main_target_commitish',
)
fail(
surfaces.releaseCommand.includes('FORGEJO_TARGET_COMMITISH: tagCommit') &&
surfaces.releaseCommand.indexOf('pushToRemotes(tag, tagCommit)') <
surfaces.releaseCommand.indexOf("'scripts/ci/publish-forgejo-release.mjs'"),
'release_command_push_after_publish',
)
// GAP-REL-11: Forgejo 러너가 지원하지 않는 actions/upload-artifact@v4 금지
fail(
!/^\s*uses:\s*actions\/upload-artifact@v4/m.test(surfaces.forgejoPortable),
'forgejo_portable_unsupported_upload_artifact',
)
for (const [name, workflow] of [
['gitlab', surfaces.gitlab],
@ -392,6 +411,23 @@ if (process.argv.includes('--self-test')) {
},
'update_service_policy_enforcement_missing',
)
expectRejected(
surfaces,
(candidate) => {
candidate.forgejoPublisher = candidate.forgejoPublisher.replaceAll(
'target_commitish: targetCommitish',
'target_commitish: "main"',
)
},
'forgejo_publisher_mutable_main_target_commitish',
)
expectRejected(
surfaces,
(candidate) => {
candidate.forgejoPortable = `${candidate.forgejoPortable}\nuses: actions/upload-artifact@v4\n`
},
'forgejo_portable_unsupported_upload_artifact',
)
let missingDesktopKeyRejected = false
try {
loadSurfaces((path) => {
@ -407,7 +443,7 @@ if (process.argv.includes('--self-test')) {
if (!missingDesktopKeyRejected) {
throw new Error('release_metadata_self_test_failed:desktop_license_public_key_missing')
}
result.negativeCases = 16
result.negativeCases = 18
}
process.stdout.write(`${JSON.stringify(result, null, 2)}\n`)