목적:
- 남은 문서 포맷, 에이전틱 루프, 개발언어 fallback, 명령/스킬 합성 작업을 한 번에 끝낼 수 있도록 통합 계획을 고정한다.
- 다음 배치부터 그대로 집행할 수 있게 참조 대상, AX 적용 위치, 완료 조건, 품질 판정 기준을 문서에 남긴다.
핵심 수정:
- README.md에 통합 마감 계획 요약과 기준 레퍼런스, 최종 게이트를 추가했다.
- docs/DEVELOPMENT.md에 문서 포맷 최종 마감, AgentLoop/Queue/Context 분리, tool_result replacement state 고정, 개발언어 no-LSP fallback 심화, 명령/스킬 합성 및 릴리즈 게이트 계획을 상세히 기록했다.
- docs/NEXT_ROADMAP.md에 다음 구현 배치의 실행 순서와 품질 판정 기준을 반영했다.
검증 결과:
- 문서 계획 반영 작업으로 코드/바이너리 변경은 없으며, 다음 배치의 구현 기준선 문서 정합성을 맞췄다.
변경 목적:
- AX Agent의 도구 이름, 내부 설정, 스킬 정책, 실행 루프 사이의 불일치를 줄이고 전체 동작 품질을 높인다.
- claw-code 수준의 일관된 동작 품질을 참고하되 AX 구조에 맞는 고유한 카탈로그·정규화 레이어로 재구성한다.
핵심 수정사항:
- 도구 canonical id, legacy alias, 탭 노출, 설정 카테고리, read-only 분류를 중앙 카탈로그로 통합했다.
- ToolRegistry, AgentLoopService, 병렬 실행 분류, 권한 처리, 훅 처리, 스킬 allowed-tools 해석이 같은 이름 체계를 사용하도록 정리했다.
- Agent 설정/일반 설정/도움말의 도구 카드와 훅 편집기, 스킬 설명을 현재 런타임 구조에 맞게 갱신했다.
- 컨텍스트 압축, intent gate, spawn agents, session learning, model prompt adapter, workspace context 관련 변경과 테스트 추가를 함께 반영했다.
- 문서 이력과 비교/로드맵 문서를 최신 상태로 갱신했다.
검증 결과:
- dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\verify_toolcat\ -p:IntermediateOutputPath=obj\verify_toolcat\ : 경고 0 / 오류 0
- dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter AgentToolCatalogTests -p:OutputPath=bin\verify_toolcat_tests\ -p:IntermediateOutputPath=obj\verify_toolcat_tests\ : 통과 8
- ChatWindow 내부 대형 slash 사전을 신규 파일 SlashCommandCatalog로 분리하여 결합도를 낮춤
- ChatWindow slash 조회 경로를 카탈로그 API(MatchBuiltinCommands, TryGetEntry)로 전환
- slash 탐색/실행 동작 회귀를 build + ChatWindowSlashPolicyTests(39건)로 검증
- docs/NEXT_ROADMAP.md에 claw-code 기준 Codex/Claude 추격 로드맵(L1~L5)과 완료 기준을 추가
- docs/DEVELOPMENT.md에 연속 실행 26차 이력(2026-04-04 13:24 KST) 기록
- README.md 업데이트 시각 및 변경 이력 항목을 최신 상태로 갱신
- TaskRunService의 권한/도구/완료/오류 기본 요약 문자열에서 깨진 문자(인코딩 깨짐) 제거
- Permission/Hook/Tool 이벤트별 기본 타이틀·요약 문구를 일관된 표현으로 정리하여 replay/요약 가독성 개선
- StopRequested 기본 요약 문구가 잘못 치환되는 문제를 수정해 취소 흐름 의미를 복구
- AGENT_ROADMAP, NEXT_ROADMAP의 테스트 스냅샷을 최신 실측값(Parity 13/13, Replay 14/14, 전체 379/379)으로 동기화
- 전역 권한이 Auto일 때 고위험 도구(process, spawn_agent, snippet_runner)는 자동 허용을 ask로 강등
- AgentContext 권한 계산 경로에 dangerous auto guard를 통합하여 우발적 무승인 실행 방지
- OperationModePolicyTests에 guard 동작 회귀 테스트 2건 추가
- 패리티 문서에 permissionSetup 기반 보강 항목 추가
- 로드맵/패리티 문서 테스트 수치 동기화: 374/374
- 검증: dotnet build 경고0 오류0, ParityBenchmark 12/12, ReplayStability 12/12, 전체 테스트 374/374
- AgentLoopE2ETests에 mixed recovery 시나리오 추가: unknown-tool 오류 이후 file_write 경유, math_eval 대체 실행, 반복 한도 내 안전 종료를 검증
- 기존 권한/복구 검증과 충돌하지 않도록 이벤트 단정식을 경로 의존 최소화 형태로 정리
- 문서 동기화: AGENT_ROADMAP/NEXT_ROADMAP/CLAW_CODE_PARITY_PLAN의 최신 검증 수치를 ParityBenchmark 12/12, ReplayStability 12/12, 전체 372/372로 갱신
- 패리티 계획 문서에 혼합 복구 내구성 시나리오와 체크리스트 항목 수(9개) 반영
- 검증 실행: dotnet build(경고0/오류0), dotnet test --filter Suite=ParityBenchmark(12/12), dotnet test --filter Suite=ReplayStability(12/12), dotnet test(372/372), scripts/release-gate.ps1 통과
- 도구 동등화: task/todo/tool-search + plan/worktree/team/cron 도구군 추가 및 ToolRegistry 등록\n- claw-code CamelCase 별칭 정규화 확장: EnterPlanMode/EnterWorktree/TeamCreate/CronCreate 등 -> 내부 snake_case 매핑\n- AgentLoop 런타임 강화: Code 탭 전용 도구 토글(CodeSettings) 반영, 비활성 도구 자동 차단\n- Worktree 상태 복원 연결: .ax/worktree_state.json 기반 루트 탐색/활성 worktree 복원 및 BuildContext 연동\n- 권한/플러그인 하드닝 기존 반영분 유지: target 기반 권한 판정 + internal 모드 플러그인 경로/manifest 검증\n- 설정 연동(UI): SettingsWindow Code 패널에 Plan/Worktree/Team/Cron 도구 on/off 토글 추가\n- 테스트 보강: AgentParityTools/AgentLoopE2E에 worktree 지속성, alias 정규화, 설정 차단 시나리오 추가\n- 검증 완료: dotnet build(경고0/오류0), ParityBenchmark 11/11, ReplayStability 12/12, 전체 371/371, release-gate 통과\n- 문서 동기화: AGENT_ROADMAP/NEXT_ROADMAP/CLAW_CODE_PARITY_PLAN 수치 및 기준 최신화
