deuk-agent-flow 4.0.19

package/CHANGELOG.ko.md

@@ -0,0 +1,223 @@
+# 변경 이력 (Changelog)
+
+이 프로젝트의 모든 주목할 만한 변경 사항은 이 파일에 기록됩니다.
+
+**English:** [CHANGELOG.md](CHANGELOG.md)
+
+형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 기반으로 하며, 이 프로젝트는 [유의적 버전(Semantic Versioning)](https://semver.org/spec/v2.0.0.html)을 준수합니다.
+
+## [Unreleased]
+
+## [4.0.12] - 2026-05-07
+
+### 수정됨 (Fixed)
+
+- **init:** 마이그레이션 중 AgentFlow spoke가 사라지지 않도록 설치된 legacy `CLAUDE.md` 표면은 `.bak` 없이 교체하고, 감지된 agent tool 표면이 없는 `.deuk-agent` 프로젝트에도 기본 root `AGENTS.md` 포인터를 설치하도록 수정했습니다.
+- **skill:** registry뿐 아니라 온디스크 `.deuk-agent/skills/<id>/SKILL.md` 파일도 설치된 skill로 판정하여 `deuk-agent-flow skill list`가 마이그레이션된 skill 디렉터리 상태를 정확히 보여주도록 수정했습니다.
+- **rules:** AgentFlow skill 상태 질문은 `deuk-agent-flow skill list`로 확인하도록 명시하고, core agent rules의 ticket 예시를 완전한 `deuk-agent-flow ticket ...` 명령으로 정규화했습니다.
+
+## [4.0.11] - 2026-05-07
+
+### 수정됨 (Fixed)
+
+- **init/ticket:** 의도했던 month-only archive 정책을 복원했습니다. `init`가 예전의 깊은 archive 레이아웃을 canonical month bucket 레이아웃으로 정규화하고, 낡은 archive depth metadata 없이 archive shard index를 다시 쓰며, 새 비정규 import가 생기지 않도록 수정했습니다.
+
+## [3.3.3] - 2026-05-06
+
+### 수정됨 (Fixed)
+
+- npm과 GitHub 첫 화면에서 영어/한국어 README를 바로 오갈 수 있도록 언어 전환 링크를 복구했습니다.
+- README 문서 표에는 공개 문서 링크만 남기고, 내부 리서치와 성장 전략 문서는 npm/OSS 공개 표면에서 제외했습니다.
+
+## [3.3.2] - 2026-05-06
+
+### 포지셔닝 (Positioning)
+
+- npm/GitHub에서 보이는 정체성을 **모든 레포를 위한 AI 코딩 에이전트 가드레일**로 재정리했습니다.
+- `AGENTS.md`, Copilot instructions, Cursor rules, Claude skills, 에이전트 실행기, 일반 LLM/MCP 가드레일과 비교해 DeukAgentFlow가 더하는 티켓 생명주기, 범위 계약, 검증, 아카이브 가능한 기억을 README에 드러냈습니다.
+- 다음 개선 방향으로 첫 실행 점검, CLI/RAG 재각인 신호, active ticket/phase/open ticket count/DeukAgentContext memory status를 보여주는 companion 표면을 명시했습니다.
+
+## [3.3.0] - 2026-05-02
+
+### 추가됨 (Added)
+
+- **docs:** VS Code, Open VSX, GitHub, skill 기반 발견 루프를 포함한 AI 코딩 에이전트 가드레일 포지셔닝, 비전, 오가닉 유입 리서치 문서를 추가했습니다.
+- **docs:** Karpathy식 skill, DeukAgentFlow, DeukAgentContext 심층 비교 문서를 추가했습니다. Skill은 행동 playbook, DeukAgentFlow는 workflow/permission control, DeukAgentContext는 ticketed engineering memory로 포지셔닝했습니다.
+- **seo:** `andrej-karpathy-skills` 관련 아이디어 링크와 Claude Code, AGENTS.md, Cursor rules, agent skills, AI guardrails 검색 유입 키워드를 보강했습니다.
+
+### 변경됨 (Changed)
+
+- **ticket:** 열린 티켓이 설정된 한도를 넘을 때 자동 정리 대신 사용자가 목록을 보고 결정할 수 있는 cleanup flow를 강화했습니다.
+- **ticket:** 닫힌 티켓은 자동 아카이브할 수 있게 하고, 아카이브된 티켓은 년월 단위 버킷으로 정리되도록 했습니다.
+- **docs:** README 문서 목록과 GitHub topic 가이드를 agent guardrail, instruction hub, skill registry, project memory 포지셔닝에 맞게 갱신했습니다.
+
+### 수정됨 (Fixed)
+
+- **ticket:** 새 작업 진입 전에 정리 결정을 노출하여 열린 티켓 수가 의도한 운영 한도를 조용히 넘는 문제를 방지했습니다.
+
+## [3.2.0] - 2026-04-29
+
+### 추가됨 (Added)
+- **agent:** 플랫폼 공존(Platform Coexistence) 및 모드 인지형(Mode-aware) 워크플로우 구현. (Plan Mode에서 TDW Phase 자동 매핑, `platform-coexistence.md` 규칙 추가, 수정 제어 및 `PROJECT_RULE.md` 포인터 연동 등)
+
+### 변경됨 (Changed)
+- **agents:** Co-existence Protocol 및 Workflow Gate 기능 도입 (T-120).
+- v3.1.0 아키텍처 원칙 및 사용법 문서 개선.
+
+## [3.1.0] - 2026-04-28
+
+### 추가됨 (Added)
+- **arch:** 제로카피(Zero-Copy) 포인터 아키텍처 도입 (`PROJECT_RULE.md` 연동) 및 구조 간소화
+- **cli:** 엄격한 Phase 기반 티켓 워크플로우 및 APC(Agent Permission Contract) 검증 기능 추가
+- **cli:** `--plan-body` 옵션을 통한 채워진 Phase 1 티켓 본문 입력 기능 추가
+- **ticket:** 티켓 아카이브 시 불필요한 토큰 낭비를 막는 Zero-Token 지식 증류(Knowledge Distillation) 구현
+- **telemetry:** 로컬 환경에 최적화된 Telemetry CLI 추가
+- **rules:** `PROJECT_RULE.md` 템플릿 추가 (AI 에이전트 폴백 가이드 포함) 및 이중 언어(한/영) 지원
+
+### 수정됨 (Fixed)
+- **rules:** `PROJECT_RULE.md` 내 중복된 코어 룰 링크 제거 및 Frontmatter 렌더링 복구
+- **telemetry:** 모델 및 설정에서 클라이언트 도구를 자동으로 감지하도록 수정
+- **agent:** 티켓 탐색 중 에이전트 무한 루프 문제 해결
+
+### 변경됨 (Changed)
+- **agent:** TDD 용어를 TDW (Ticket-Driven Workflow)로 변경 및 전역 `AGENTS.md`에서 낡은 규칙 제거
+- **cli:** 상태 기반(State-driven) 경로 탐색 로직으로 구조 개편 및 상세한 사용 가이드 추가
+
+## [3.0.0] - 2026-04-25
+
+### 🚀 대규모 업데이트: Hub-Spoke 아키텍처
+- **Canonical Rule Hub**: 모든 AI 에이전트의 단일 진실 공급원(SSOT)으로 `AGENTS.md` 도입.
+- **Thin Spoke Pointers**: IDE별 룰(Cursor, Copilot 등)을 중앙 Hub를 가리키는 가벼운 포인터로 변경하여 중복 및 동기화 오류 제거.
+- **Global CLI Proxy**: 로컬 워크스페이스 소스를 자동 감지하여 실행을 위임하는 프록시 도입으로 지연 없는(Zero-latency) 개발 환경 구축.
+
+### 🧹 제로 레거시 & 환경 정리
+- **Auto-Purge**: `init` 실행 시 더 이상 사용되지 않는 레거시 `.cursorrules` 파일을 무조건 삭제.
+- **Smart Backups**: 사용자 정의 규칙을 감지하여 삭제 대신 `.bak` 파일로 백업하는 로직 추가.
+- **Submodule Scrubbing**: 비어 있는 서브모듈 디렉터리 스텁 및 `.gitmodules` 자동 정리 기능.
+
+### 🏗️ 리브랜딩 & 인프라스텍
+- **Identity Overhaul**: "Zero-Latency, High-Signal AI Orchestration Protocol"로 리브랜딩.
+- **Documentation v3**: 고품질 3D 인포그래픽 및 구조, 원리, 작동 방식 등 개념 가이드 전면 개편.
+- **Domain Agnostic**: 도메인별 하드코딩을 제거하고 모든 기술 스택을 지원하도록 `bundle/AGENTS.md` 일반화.
+
+### ⚙️ CLI 개선 사항
+- **Proxy Routing**: `bin/deuk-agent-rule.js`가 디렉터리를 탐색하여 로컬 스크립트를 찾아 실행하도록 수정.
+- **Synchronized IO**: CLI의 안정성을 높이기 위해 핵심 로직을 동기적 파일 시스템 연산으로 리팩터링.
+## [2.4.6] - 2026-04-19
+
+### 수정됨 (Fixed)
+
+- **cli:** 로컬 버전이 registry 버전 이상일 경우 업데이트 알림을 표시하지 않도록 수정 (로컬 개발 symlink 환경에서의 역방향 스팸 알림 해소)
+- **ticket:** `NNN` 정규식을 최대 4자리로 제한하여 유닉스 타임스탬프가 티켓 순번으로 잘못 파싱되는 버그 수정 — 올바른 `NNN-topic-hostname` 포맷 생성 복원
+
+## [2.4.4] - 2026-04-19
+
+### 변경됨 (Changed)
+
+- **rules:** 서브모듈 전용 규칙(DeukPack, C++, Unity)을 해당 워크스페이스의 `MODULE_RULE.md`로 이동하여 `AGENTS.md`를 일반화된 규약 중심으로 개편
+- **templates:** `publish/` 소스에 맞춰 `bundle/` 내의 레거시 템플릿 정리
+
+## [2.4.3] - 2026-04-18
+
+### 변경됨 (Changed)
+- **ticket:** 티켓 ID 포맷을 `NNN-topic-hostname` (예: `001-add-feature-joy-nucb`)으로 변경. 레거시 `ticket_NNN_hostname_topic` 형식 대체
+- **ticket:** INDEX.json 파싱 시 기존 포맷과 신규 포맷 모두 역호환 지원
+
+## [2.4.2] - 2026-04-18
+
+### 수정됨 (Fixed)
+- **ticket:** 파일명(File name)과 본문 내 티켓 ID 생성 로직 간의 불일치(Discrepancy) 해결 (단일 출처로 통합)
+
+## [2.4.1] - 2026-04-18
+
+### 추가됨 (Added)
+- **cli:** NPM 최신 버전을 감지하여 터미널에 업데이트를 권고하는 알림 기능(Update Notifier) 추가
+
+### 수정됨 (Fixed)
+- **ticket:** 티켓 생성 시 호스트명 슬러그가 8글자로 엄격히 제한되지 않던 버그 수정
+
+## [2.4.0] - 2026-04-18
+
+### 추가됨 (Added)
+
+- **init:** 깔끔한 마이그레이션을 위한 구버전 템플릿 자동 정리 기능 추가
+- **rules:** `AGENTS.md` 문서 내 티켓 검증 단계(TICKET VERIFICATION RULE) 규약 추가
+- **ticket:** 티켓에 우선순위(Priority) 속성 추가
+- **ticket:** 순차 번호 및 호스트네임 기반의 티켓 식별자(ID) 자동 생성 도입 (`NNN-hostname-topic` 포맷)
+- **ticket:** 호스트네임 길이 제한(8자) 및 자동 순번 부여 로직 개선
+
+### 수정됨 (Fixed)
+
+- **rules:** 전역 `npx` 캐시 이슈(과거 버전 실행 문제)를 우회하기 위해 로컬 최신 스크립트 호출을 강제/권장하도록 수정
+- **scripts:** OSS 미러 저장소 동기화 시 잘못 표기되던 URL 예시 로그 메시지 정정
+
+### 변경됨 (Changed)
+
+- **docs:** 리드미(README) 파일에 [Step 4] 티켓 검증 안내 추가
+- **docs:** 전역 설치(Global Install) 권장 안내 및 운영체제(OS)별 권한 제약 명확화
+- **rules:** 구현 아티팩트(`implementation_plan.md` 등) 내 티켓 번호 참조 의무화
+
+## [2.3.2] - 2026-04-17
+
+### 수정됨 (Fixed)
+
+- **cli:** 배포 환경에서 하드코딩된 `yaml` 의존성 경로 문제(`ERR_MODULE_NOT_FOUND`) 해결
+- **dependencies:** `yaml`을 명시적 의존성 목록에 추가
+
+## [2.3.1] - 2026-04-17
+
+### 변경됨 (Changed)
+
+- **readme:** 체인지로그 및 자동화된 릴리즈 프로세스 가이드 추가
+
+## [2.3.0] - 2026-04-17
+
+### 추가됨 (Added)
+
+- AI 파이프라인 연동 기반 및 선택적 동기화 시스템 고도화
+- **cli:** ticket list 명령에 --submodule 필터 추가
+- **cli:** 티켓 아카이브 및 리포트 워크플로를 모듈형 아키텍처로 복구
+- **rules:** Unity Client, WebApp, C++ 서버 하이브리드 환경을 위한 룰 고도화
+- **ticket:** 분산형 티켓 관리 및 공유 정책 구현
+- **ticket:** V2 YAML Front-matter 및 카테고리화된 리스트로 업그레이드
+
+### 수정됨 (Fixed)
+
+- **ticket:** LATEST.md를 폐기하고 ACTIVE_TICKET.md로 포인터 통일
+- **ticket:** DeukAgentFlow 현재 진행 중인 티켓 안 나오던 문제 해결
+
+## [1.0.14] - 2026-04-02
+
+### 추가됨 (Added)
+
+- **cli:** 병합 도구 및 배포 문서 동기화 스크립트 확장
+- **rules:** 커밋 제목 내 'sync' 금지 구문 룰 추가
+- **handoff:** 인덱스 기반 Handoff 워크플로 및 CLI 신설
+- **architecture:** 제로-터치 NPM 번들 스캐폴딩으로 템플릿 아키텍처 개편
+
+### 수정됨 (Fixed)
+
+- **cli:** 템플릿 생성기(init) 내부의 HTML 엔티티 문법 에러 핫픽스
+
+### 변경됨 (Changed)
+
+- **docs:** 외부 공개용 릴리즈 가이드 및 동기화 스크립트 주석 갱신
+- **docs:** 리드미(README)에 토큰 비용 차단 메커니즘 설정 및 제로 터치 스캐폴딩 문서 개편
+## [4.0.19] - 2026-05-08
+
+### 수정됨 (Fixed)
+
+- **publish:** init 시 레거시 DeukAgentRules 포인터가 새 DeukAgentFlow managed block 옆에 남지 않도록 generated spoke 교체 경로를 복구했습니다.
+- **telemetry:** release 검증의 architecture guard를 통과하도록 client label 정규화를 공용 `toSlug` 유틸로 통일했습니다.
+
+### 변경됨 (Changed)
+
+- **docs:** 영문/한글 메인테이너 배포 섹션을 dual-package npm 배포 흐름과 통합 다운로드 배지 설명 기준으로 맞췄습니다.
+
+## [4.0.18] - 2026-05-08
+
+### 수정됨 (Fixed)
+
+- **skills:** `init` 정리 단계가 `.deuk-agent/skills.json`과 `usage.json`을 오배치 파일로 이동시키던 회귀를 막고, 실제 Claude/Cursor 노출 파일도 `skill list`에 반영하도록 보강
+- **telemetry:** 모델/클라이언트 표기를 정규화해 대소문자·공백 차이로 분석 결과가 분산되던 문제 수정
+- **ticket:** active ticket 동기화가 가장 최근 open ticket 대신 오래된 open ticket을 유지해 `ticket continue`가 잘못된 티켓을 가리키던 문제 수정

package/CHANGELOG.md

@@ -0,0 +1,227 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Fixed
+
+- **cli:** stop ticket discovery at the current agent-rule boundary instead of inheriting the parent workspace.
+
+## [4.0.12] - 2026-05-07
+
+### Fixed
+
+- **init:** preserve AgentFlow spokes during migration by replacing installed legacy `CLAUDE.md` surfaces without creating `.bak` files, while still installing a default root `AGENTS.md` pointer for `.deuk-agent` projects without detected agent tool surfaces.
+- **skill:** report installed skills from either the registry or on-disk `.deuk-agent/skills/<id>/SKILL.md` files so `deuk-agent-flow skill list` reflects migrated skill directories.
+- **rules:** map AgentFlow skill-status questions to `deuk-agent-flow skill list` and use fully qualified `deuk-agent-flow ticket ...` command examples in the core agent rules.
+
+## [4.0.11] - 2026-05-07
+
+### Fixed
+
+- **init/ticket:** restore the intended month-only archive policy by normalizing older deep archive layouts into the canonical month bucket layout, rebuilding archive shard indexes without obsolete archive-depth metadata, and preventing new non-canonical imports during `init`.
+
+## [3.3.3] - 2026-05-06
+
+### Fixed
+
+- Restored the README language switch links so npm and GitHub readers can move between English and Korean documentation from the first screen.
+- Published only public documentation links in the README tables while keeping internal research and growth notes out of the npm/OSS surface.
+
+## [3.3.2] - 2026-05-06
+
+### Positioning
+
+- Reframed the npm/GitHub identity around **AI coding agent guardrails for every repo**, with ticketed scope, verification, and shared `AGENTS.md` workflows visible in package metadata.
+- Added README comparison against `AGENTS.md`, Copilot instructions, Cursor rules, Claude skills, agent harnesses, and general guardrail frameworks to show where DeukAgentFlow sits in the ecosystem.
+- Added a short "What's Next" section to set expectations for clearer first-run checks, compact CLI/RAG reminders, and visible companion surfaces for active ticket, phase, open-ticket count, and DeukAgentContext memory status.
+
+
+### Added
+
+-  AGENTS.md v12 + summary mandatory guard + PROJECT_RULE optimization
+- **cli:** add 'ticket next' command for instant task discovery (T[#295](https://github.com/joygram/DeukAgentFlow/issues/295))
+- **cli:** enforce required frontmatter keys in lint:md (T-118)
+-  harden ticket paths and add DeukPack RAG schemas
+- **migration:** add summary/planLink/caution auto-enrichment for legacy tickets
+-  Phase 0 search limiter - max 2 MCP calls, skip when context sufficient
+-  replace legacy fill-in-the-blank rule check with Version Gating and Task Relevance check
+- **rules:** enforce hard guardrails, add hotfix protocol and urgency response
+- **rules:** harden document boundary workflow
+- **spoke:** add fill-in completion template for rule enforcement
+- **T-114:** 1-CALL ticket discovery rule + CLI max call limits
+- **T-115:** HARD BLOCK on write tools without active ticket
+- **T-116:** auto-close stale tickets on ticket create + Phase 4 NEVER skip
+- **T-116:** smart close based on checklist + phase state
+- **ticket:** enforce filled create flow and phase1 status guard
+- **ticket:** enforce open ticket cleanup flow
+- **ticket:** partition archive index by month
+
+
+### Fixed
+
+-  add Refactor Safety Guard and Halt-and-Replan hard rules
+-  agent degradation remediation — planLink, inline TDW, token optimization
+-  align ticket APC template with phase gate
+- **docs:** correct frontmatter keys in AGENTS.md (remove fm_ prefix)
+- **init:** deploy Antigravity spoke to project root AGENTS.md
+-  register legitimate DR-04/DR-05 exceptions and update PROJECT_RULE.md
+-  remove duplicate phase key in ticket template and repair broken tickets
+- **rules:** announce active ticket at start
+- **rules:** keep planlink free of progress checkboxes
+- **rules:** make planlink capture agent analysis
+- **rules:** separate ticket and plan content
+- **spoke:** GLOBAL_AGENTS.md link text to actual filename AGENTS.md
+-  SSOT — init removes .deuk-agent/templates/ unconditionally (bundle is single source of truth)
+- **T-116:** parallel-safe auto-close - only close activeTicketId, warn others
+- **T-116:** replace auto-close with activeTicketId switch + warning
+- **ticket:** honor project and submodule filters
+- **ticket:** Sync close/archive status to frontmatter to prevent rebuild reversion
+
+
+### Changed
+
+-  add Dependency Integrity Guard (HARD RULE) to AGENTS.md
+-  add lite accessibility vision plan
+-  add skill positioning release notes
+-  add version frontmatter to AGENTS.md for rule loading optimization
+-  align bad examples with plan/archive convention
+-  archive bmt coordination ticket 142
+-  archive bmt frontmatter cleanup ticket 144
+-  archive bmt go ticket 140
+-  archive bmt java ticket 139
+-  archive bmt matrix ticket 133
+-  archive bmt rust ticket 141
+-  bump AGENTS.md to v15 and strengthen dependency guards
+-  clarify ticket creation flow
+-  document rationale for docs/plan and fix section numbering
+-  Enforce strict rules for Scope Creep Handling
+-  enhance main features and workflow intro for v3.2.0
+-  optimize AGENTS.md — merge Dependency Integrity into Refactor Guard, compress Scope Creep
+-  position agent guardrail growth loop
+- **rules:** clarify phase one execution semantics
+- **rules:** mandate enrich_frontmatter for all plan/report files (T-118)
+- **spoke:** hard rule single directive
+-  update legacy path guidance to plan/archive layout
+
+## [3.3.0] - 2026-05-02
+
+### Added
+
+- **docs:** add AI coding agent guardrail positioning, vision, and organic growth research for VS Code, Open VSX, GitHub, and skill-driven discovery.
+- **docs:** add a deep comparison of Karpathy-style skills, DeukAgentFlow, and DeukAgentContext, positioning skills as behavior playbooks, DeukAgentFlow as workflow/permission control, and DeukAgentContext as ticketed engineering memory.
+- **seo:** add related-project positioning for `andrej-karpathy-skills` plus discovery keywords for Claude Code, AGENTS.md, Cursor rules, agent skills, and AI guardrails.
+
+### Changed
+
+- **ticket:** enforce a decision-first cleanup flow when open tickets exceed the configured limit, while allowing closed tickets to be archived automatically.
+- **ticket:** organize archived tickets by year-month buckets to reduce active ticket repository clutter.
+- **docs:** update README document indexes and GitHub topic guidance to emphasize the agent guardrail, instruction hub, skill registry, and project memory positioning.
+
+### Fixed
+
+- **ticket:** prevent open ticket growth from silently exceeding the intended operating limit by surfacing cleanup decisions before new work proceeds.
+
+## [3.2.0] - 2026-04-28
+
+
+### Added
+
+- **agent:** implement platform coexistence and mode-aware workflow
+
+
+### Changed
+
+- **agents:** add Co-existence Protocol and Workflow Gate (T-120)
+-  update usage, architecture, and principles for v3.1.0
+
+## [3.1.0] - 2026-04-28
+
+
+### Added
+
+-  add ArchitectureGuard.test.mjs and create technical debt ticket T-103
+-  add first-class copilot and codex support
+- **arch:** implement APC v3 and simplify repository structure
+- **cli:** restrict --skip-phase0 based on MCP server status and update rules
+-  consolidate rule cleanup logic and enforce thin pointers for entry points
+-  enforce unidirectional AGENTS.md single source of truth
+-  enhance CLI reporting and add practical usage guide
+-  implement strict phase-driven ticket workflow with APC validation
+-  implement Zero-Copy architecture with absolute path pointing and frontmatter-based PROJECT_RULE.md
+-  implement zero-token knowledge distillation on ticket archive and cleanup dead code
+- **rules:** add AI Agent fallback guide to PROJECT_RULE.md template
+- **rules:** normalize canonical rules and decouple DeukPack rules
+- **telemetry:** add local-first telemetry CLI and update AGENTS.md
+- **ticket:** implement --plan-body for filled Phase 1 ticket body input and update project rules
+
+
+### Fixed
+
+-  auto-detect client tool from model and config in telemetry
+-  resolve agent loop on ticket navigation + archive 37 dead tickets
+- **rules:** bilingual ko/en PROJECT_RULE.md template
+- **rules:** remove redundant core rules link from PROJECT_RULE.md
+- **rules:** restore frontmatter in PROJECT_RULE.md
+- **rules:** restore mandatory ticket workflow and anti-shoveling rules
+- **rules:** sync restored strict workflow AGENTS.md and unified templates
+
+
+### Changed
+
+-  add markdown lint policy and workflow docs
+- **agent:** rename TDD to TDW, archive ticket 101, and remove DOMAIN_RULES
+-  AGENTS.md full cleanup - eliminate redundancy, unify English, remove dead rules
+-  finalize ticket 066 rule normalization
+-  modernize CLI architecture, implement state-driven path resolution, and comprehensive audit cleanup
+- **rules:** decouple DeukPack rules and fix merge injection logic
+-  update principles and cli compiler to DeukAgentContext
+
+## [3.0.0] - 2026-04-25
+
+### 🚀 Major Breakthrough: Hub-Spoke Architecture
+- **Canonical Rule Hub**: Introduced `AGENTS.md` as the single source of truth for all AI agents.
+- **Thin Spoke Pointers**: IDE-specific rules (Cursor, Copilot, etc.) are now lightweight pointers to the central Hub, eliminating duplication and sync errors.
+- **Global CLI Proxy**: Implemented a smart entry point that automatically detects and routes execution to local workspace sources, ensuring zero-latency development.
+
+### 🧹 Zero-Legacy & Cleanliness
+- **Auto-Purge**: `init` now unconditionally deletes deprecated `.cursorrules` files.
+- **Smart Backups**: Added logic to detect custom user rules and rename files to `.bak` instead of deletion.
+- **Submodule Scrubbing**: Automatically cleans empty submodule directory stubs and scrubs `.gitmodules`.
+
+### 🏗️ Branding & Infrastructure
+- **Identity Overhaul**: Rebranded as a "Zero-Latency, High-Signal AI Orchestration Protocol".
+- **Documentation v3**: New high-end 3D visual infographics and overhauled conceptual guides (Architecture, Principles, How-it-works).
+- **Domain Agnostic**: Generalized `bundle/AGENTS.md` to support any technology stack, removing domain-specific hardcoding.
+
+### ⚙️ CLI Enhancements
+- **Proxy Routing**: `bin/deuk-agent-rule.js` performs directory traversal to find local scripts.
+- **Synchronized IO**: Refactored core logic to use synchronous FS operations for rock-solid CLI stability.
+
+---
+
+## [2.4.0] - 2026-04-18
+- add Codex CLI support (.codexrules) and apply globally
+- implement ticket chaining (--chain) for automated ticket linkage
+- improve submodule isolation logic
+## [4.0.19] - 2026-05-08
+
+### Fixed
+
+- **publish:** restore generated spoke replacement during init so legacy DeukAgentRules pointers do not survive beside the new DeukAgentFlow managed block
+- **telemetry:** switch client-label normalization to the shared `toSlug` utility so architecture guard tests pass during release validation
+
+### Changed
+
+- **docs:** align the English and Korean maintainer publish sections around the dual-package npm flow and the combined downloads badge
+
+## [4.0.18] - 2026-05-08
+
+### Fixed
+
+- **skills:** preserve `.deuk-agent/skills.json` and `usage.json` during init layout cleanup, and let `skill list` detect real Claude/Cursor exposure pointers even when registry state is stale
+- **telemetry:** normalize model/client labels so analytics do not fragment across case and spacing variants
+- **ticket:** prefer the newest open ticket when syncing the active ticket pointer so `ticket continue` follows the current work instead of an older open ticket

package/LICENSE

@@ -0,0 +1,184 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship made available under
+      the License, as indicated by a copyright notice that is included in
+      or attached to the work (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean, as submitted to the Licensor for inclusion
+      in the Work by the copyright owner or by an individual or Legal Entity
+      authorized to submit on behalf of the copyright owner. For the purposes
+      of this definition, "submitted" means any form of electronic, verbal,
+      or written communication sent to the Licensor or its representatives,
+      including but not limited to communication on electronic mailing lists,
+      source code control systems, and issue tracking systems that are managed
+      by, or on behalf of, the Licensor for the purpose of submitting and
+      discussing modifications to the Work, but excluding communication that
+      is conspicuously marked or designated in writing by the copyright owner
+      as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor and included
+      within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by the combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a cross-claim
+      or counterclaim in a lawsuit) alleging that the Work or any other
+      Contribution embodied in the Work constitutes patent or contributory
+      patent infringement, then any patent rights granted to You under
+      this License for that Work shall terminate as of the date such
+      litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, You must include a readable copy of the
+          attribution notices contained within such NOTICE file, in
+          at least one of the following places: within a NOTICE text
+          file distributed as part of the Derivative Works; within
+          the Source form or documentation, if provided along with the
+          Derivative Works; or, within a display generated by the
+          Derivative Works, if and wherever such third-party notices
+          normally appear. The contents of the NOTICE file are for
+          informational purposes only and do not modify the License.
+          You may add Your own attribution notices within Derivative
+          Works that You distribute, alongside or as an addendum to
+          the NOTICE text from the Work, provided that such additional
+          attribution notices cannot be construed as modifying the License.
+
+      You may add Your own license statement for Your modifications and
+      may provide additional grant of rights to use, copy, modify, merge,
+      publish, distribute, sublicense, and/or sell copies of the Work,
+      and to permit persons to whom the Work is furnished to do so,
+      subject to the following conditions:
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any conditions of TITLE,
+      NONINFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+      PURPOSE. You are solely responsible for determining the
+      appropriateness of using or reproducing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or exemplary damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or all other
+      commercial damages or losses), even if such Contributor has been
+      advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may offer such
+      conditions only on Your own behalf and on Your sole responsibility,
+      not on behalf of any other Contributor, and only if You agree to
+      indemnify, defend, and hold each Contributor harmless for any
+      liability incurred by, or claims asserted against, such Contributor
+      by reason of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 Deukware and contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.