Skip to content

v2.13.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 22 Apr 16:38
· 1254 commits to main since this release
v2.13.0
f040c58
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

v2.13.0 - /moai design Unification + DB Workflow Integration (2026-04-23)

Summary

Three independent workstreams converged in this release:

  1. SPEC-AGENCY-ABSORB-001 absorption (#682) — /agency command and agents absorbed into the unified /moai design hybrid workflow. Brand context promoted to .moai/project/brand/ as a constitutional constraint.
  2. Design + DB 8-SPEC integrated delivery — .moai/design/ folder scaffolding, /moai db command family, Pencil MCP integration, PostToolUse DB sync hook, and /moai project Phase 4.1a DB detection.
  3. Profile setup wizard hardening (#681) — 16 review findings applied, silent data coercion of deprecated Claude IDs fixed, ast_grep_gate SAST re-enabled, team role_profiles rebalanced for Opus 4.7 / 1M-context models.

Additional highlights: LSP server detection fix restoring 16-language support (#689), moai glm settings.local.json pollution fix (#691), charmbracelet/x/powernap v0.1.3 → v0.1.4 (#679), Hextra-based docs-site monorepo integration (#680).

Breaking Changes

  • /agency command deprecated — now redirects to /moai design. Full removal scheduled per REQ-DEPRECATE-003 (2 minor versions after this release).

Added

Design workflow (SPEC-AGENCY-ABSORB-001, SPEC-DESIGN- series)*

  • /moai design subcommand — Hybrid design workflow (Claude Design import path + code-based skill path)
  • moai migrate agency command — Safe migration of .agency/ data to .moai/project/brand/ and .moai/config/sections/design.yaml
  • moai-domain-copywriting, moai-domain-brand-design, moai-workflow-design-import, moai-workflow-gan-loop, moai-workflow-design-context, moai-workflow-pencil-integration skills
  • .moai/design/ folder scaffolding with SHA-256 based user-edit preservation on moai update
  • .moai/project/brand/ directory — brand-voice.md, visual-identity.md, target-audience.md templates
  • .moai/config/sections/design.yaml — Design pipeline configuration (GAN loop, sprint contract, evolution thresholds)
  • .claude/rules/moai/design/constitution.md v3.3.0 — Section 3 tripartite structure (Brand Context / Design Brief / Relationship)

DB workflow (SPEC-DB- series)*

  • /moai db subcommand supporting init/refresh/verify/list with 16-language migration path mapping
  • .moai/project/db/ 7-file template set (README, schema.md, erd.mmd, migrations.md, rls-policies.md, queries.md, seed-data.md)
  • .moai/config/sections/db.yaml with 6 migration patterns (Prisma/Alembic/Rails/SQL/Supabase/generic)
  • moai-domain-db-docs skill — Migration file parser + schema.md/erd.mmd/migrations.md synchronizer
  • moai hook db-schema-sync + handle-db-schema-change.sh PostToolUse hook (10s debounce, path traversal guard)
  • /moai project Phase 4.1a DB Detection — Auto-detects DB technology from tech.md and 16-language dependency manifests

Profile setup wizard hardening (#681)

  • normalizeModel(m string) string helper preventing silent loss of saved preferences
  • Statusline migration banner (4 languages) + auto permission mode option
  • New unit tests at 100% line coverage for new helpers

Changed

  • Agency agents catalog reduced from 6 to 2 (copywriter, designer absorbed into skills)
  • /agency redirects to /moai design with deprecation warning
  • printProfileSummary refactored for testability (accepts io.Writer)
  • workflow.yaml role_profiles: team lead → opus[1m], architect → opus, reviewer → sonnet (up from haiku)
  • charmbracelet/x/powernap v0.1.3 → v0.1.4 (#679, LSP server data refresh)

Fixed

LSP server detection restored across 16 languages (#689)

  • Corrected lsp.yaml template YAML key binary → command (aligns with ServerConfig YAML tags)
  • Added file_extensions across all 16 languages, restoring detectLanguage() file-to-server routing
  • Added 3 template compliance tests to prevent schema drift regression

moai glm settings.local.json permanent pollution fix (#691)

  • Removed injectGLMEnvForTeam() call from applyGLMMode — GLM env vars no longer persisted to settings.local.json
  • Added context-limit warning at moai glm startup (DISABLE_PROMPT_CACHING impact, Z.AI concurrency, GLM context windows)
  • Narrowed injectGLMEnvForTeam scope to enableTeamMode() path only
  • Added 3 regression tests inverting prior pollution-based tests

DB hardening (SPEC-DB-SYNC-HARDEN-001)

  • File size guard (1 MiB limit), CheckDebounce atomicity (O_EXCL + os.Rename)
  • settings.json.tmpl Windows platform branch alignment
  • internal/hook/dbsync coverage 79.2% → 85.7%
  • godoc for 5 exported helpers

Removed

  • .claude/agents/agency/* — planner, builder, evaluator, learner, copywriter, designer
  • .claude/skills/agency-* — 5 forked skills
  • .claude/skills/agency/ orchestrator skill
  • fork-manifest.yaml (absorbed into moai-workflow-research)

Deprecated

  • /agency subcommands (brief, build, review, learn, evolve, resume, profile) redirect to /moai equivalents — scheduled for removal per REQ-DEPRECATE-003 (2 minor versions after this release)

Migration

  • Projects with .agency/ directories: run moai migrate agency
  • Migration is atomic, reversible (.agency.archived/), and handles SIGINT/SIGTERM with --resume flag
  • Full behavior: see SPEC-AGENCY-ABSORB-001 acceptance.md

Installation & Update

# Existing users update
moai update

# Verify version
moai version

Fresh install instructions and migration from v1.x Python version: see project README at https://github.com/modu-ai/moai-adk

v2.13.0 - /moai design 통합 + DB 워크플로우 신설 (2026-04-23)

요약

세 개의 독립 워크스트림이 이번 릴리즈에서 수렴되었습니다.

  1. SPEC-AGENCY-ABSORB-001 흡수 완료 (#682) — /agency 명령어와 에이전트가 통합 /moai design 하이브리드 워크플로우로 흡수되었습니다. 브랜드 컨텍스트가 .moai/project/brand/로 승격되어 헌법적 제약으로 작동합니다.
  2. Design + DB 8 SPEC 통합 구현 — .moai/design/ 폴더 스캐폴딩, /moai db 명령어 패밀리, Pencil MCP 통합, PostToolUse DB 동기화 훅, /moai project Phase 4.1a DB 감지.
  3. Profile setup wizard 하드닝 (#681) — 16개 리뷰 지적사항 반영, deprecated Claude ID 무음 데이터 강제 변환 수정, ast_grep_gate SAST 재활성화, Opus 4.7 / 1M 컨텍스트 모델에 맞춰 팀 role_profiles 재조정.

추가 하이라이트: LSP 서버 감지 수정으로 16개 언어 지원 복원 (#689), moai glm settings.local.json 오염 수정 (#691), charmbracelet/x/powernap v0.1.3 → v0.1.4 (#679), Hextra 기반 docs-site 모노레포 통합 (#680).

주요 변경 사항 (Breaking Changes)

  • /agency 명령어 deprecated — /moai design으로 리다이렉트. REQ-DEPRECATE-003에 따라 본 릴리즈 2개 마이너 버전 후 완전 제거 예정.

추가됨 (Added)

Design 워크플로우 (SPEC-AGENCY-ABSORB-001, SPEC-DESIGN- 패밀리)*

  • /moai design 서브 명령어 — 하이브리드 디자인 워크플로우 (Claude Design 임포트 경로 + 코드 기반 스킬 경로)
  • moai migrate agency 명령어 — .agency/ 데이터를 .moai/project/brand/와 .moai/config/sections/design.yaml로 안전 마이그레이션
  • 6개 신규 스킬: moai-domain-copywriting, moai-domain-brand-design, moai-workflow-design-import, moai-workflow-gan-loop, moai-workflow-design-context, moai-workflow-pencil-integration
  • .moai/design/ 폴더 스캐폴딩 — moai update 시 SHA-256 기반 사용자 수정 보존
  • .moai/project/brand/ 디렉토리 — brand-voice.md, visual-identity.md, target-audience.md 템플릿
  • .moai/config/sections/design.yaml — 디자인 파이프라인 설정 (GAN loop, sprint contract, evolution 임계치)
  • .claude/rules/moai/design/constitution.md v3.3.0 — Section 3 삼분할 구조 (Brand Context / Design Brief / Relationship)

DB 워크플로우 (SPEC-DB- 패밀리)*

  • /moai db 서브 명령어 — init/refresh/verify/list 지원, 16개 언어 마이그레이션 경로 매핑
  • .moai/project/db/ 7-파일 템플릿 세트 (README, schema.md, erd.mmd, migrations.md, rls-policies.md, queries.md, seed-data.md)
  • .moai/config/sections/db.yaml — 6개 마이그레이션 패턴 (Prisma/Alembic/Rails/SQL/Supabase/generic)
  • moai-domain-db-docs 스킬 — 마이그레이션 파서 + schema.md/erd.mmd/migrations.md 동기화
  • moai hook db-schema-sync + handle-db-schema-change.sh PostToolUse 훅 (10초 debounce, path traversal 가드)
  • /moai project Phase 4.1a DB 감지 — tech.md + 16-언어 의존성 매니페스트 기반 DB 기술 자동 감지

Profile setup wizard 하드닝 (#681)

  • normalizeModel(m string) string 헬퍼 — 저장된 설정 무음 손실 방지
  • 4개 언어 statusline 마이그레이션 배너 + auto 권한 모드 선택지
  • 신규 헬퍼 100% 라인 커버리지 단위 테스트

변경됨 (Changed)

  • Agency 에이전트 카탈로그 6 → 2 축소 (copywriter, designer가 스킬로 흡수)
  • /agency 명령어가 deprecation 경고와 함께 /moai design으로 리다이렉트
  • printProfileSummary 테스트 가능하도록 리팩토링 (io.Writer 주입)
  • workflow.yaml role_profiles 재조정 — 팀 리더 → opus[1m], architect → opus, reviewer → sonnet (기존 haiku 상향)
  • charmbracelet/x/powernap v0.1.3 → v0.1.4 (#679, LSP 서버 데이터 리프레시)

수정됨 (Fixed)

LSP 서버 감지 16개 언어 복원 (#689)

  • lsp.yaml 템플릿 YAML 키 binary → command 수정 (ServerConfig YAML 태그 일치)
  • 16개 언어 전체에 file_extensions 추가 (detectLanguage() 파일-서버 라우팅 복원)
  • 템플릿 준수 테스트 3종 추가하여 스키마 드리프트 재발 방지

moai glm settings.local.json 영구 오염 수정 (#691)

  • applyGLMMode에서 injectGLMEnvForTeam() 호출 제거 — GLM 환경변수가 settings.local.json에 영구 기록되던 동작 방지
  • moai glm 시작 시 메인 세션 컨텍스트 한도 경고 메시지 추가 (DISABLE_PROMPT_CACHING 영향, Z.AI 동시성 한도, GLM 컨텍스트 윈도우 안내)
  • injectGLMEnvForTeam 범위를 enableTeamMode() 경로로만 제한
  • 기존 오염 테스트를 역전시킨 회귀 테스트 3종 추가

DB 하드닝 (SPEC-DB-SYNC-HARDEN-001)

  • 파일 크기 가드 (1 MiB 제한), CheckDebounce 원자성 (O_EXCL + os.Rename)
  • settings.json.tmpl Windows 분기 정렬
  • internal/hook/dbsync 커버리지 79.2% → 85.7%
  • 5개 exported helper godoc 추가

제거됨 (Removed)

  • .claude/agents/agency/* — planner, builder, evaluator, learner, copywriter, designer
  • .claude/skills/agency-* — 5개 포크된 스킬
  • .claude/skills/agency/ 오케스트레이터 스킬
  • fork-manifest.yaml (moai-workflow-research에 흡수)

Deprecated

  • /agency 서브명령어 (brief, build, review, learn, evolve, resume, profile)은 /moai 상응 서브명령어로 리다이렉트. REQ-DEPRECATE-003에 따라 2개 마이너 버전 후 제거 예정

마이그레이션 (Migration)

  • .agency/ 디렉토리를 가진 기존 프로젝트는 moai migrate agency로 마이그레이션 가능
  • 마이그레이션은 atomic 및 reversible (.agency.archived/로 보존), SIGINT/SIGTERM 시 --resume 플래그 지원
  • 전체 동작은 SPEC-AGENCY-ABSORB-001 acceptance.md 참조

설치 및 업데이트 (Installation & Update)

# 기존 사용자 업데이트
moai update

# 버전 확인
moai version

신규 설치 및 Python 버전(v1.x)에서 마이그레이션 안내는 프로젝트 README 참조: https://github.com/modu-ai/moai-adk

Assets 9
Loading