deuk-agent-rule 2.5.13 → 3.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/CHANGELOG.ko.md +74 -0
  2. package/CHANGELOG.md +138 -316
  3. package/README.ko.md +134 -154
  4. package/README.md +121 -153
  5. package/package.json +29 -7
  6. package/scripts/cli-args.mjs +87 -3
  7. package/scripts/cli-init-commands.mjs +1382 -223
  8. package/scripts/cli-init-logic.mjs +28 -16
  9. package/scripts/cli-prompts.mjs +13 -4
  10. package/scripts/cli-rule-compiler.mjs +44 -34
  11. package/scripts/cli-skill-commands.mjs +172 -0
  12. package/scripts/cli-telemetry-commands.mjs +429 -0
  13. package/scripts/cli-ticket-commands.mjs +1934 -161
  14. package/scripts/cli-ticket-index.mjs +298 -0
  15. package/scripts/cli-ticket-migration.mjs +320 -0
  16. package/scripts/cli-ticket-parser.mjs +207 -0
  17. package/scripts/cli-utils.mjs +381 -59
  18. package/scripts/cli.mjs +99 -19
  19. package/scripts/lint-md.mjs +247 -0
  20. package/scripts/lint-rules.mjs +143 -0
  21. package/scripts/merge-logic.mjs +13 -306
  22. package/scripts/plan-parser.mjs +53 -0
  23. package/templates/MODULE_RULE_TEMPLATE.md +11 -0
  24. package/templates/PROJECT_RULE.md +47 -0
  25. package/templates/TICKET_TEMPLATE.ko.md +21 -0
  26. package/templates/TICKET_TEMPLATE.md +21 -0
  27. package/templates/rules.d/deukcontext-mcp.md +31 -0
  28. package/templates/rules.d/platform-coexistence.md +29 -0
  29. package/templates/skills/context-recall/SKILL.md +25 -0
  30. package/templates/skills/generated-file-guard/SKILL.md +25 -0
  31. package/templates/skills/safe-refactor/SKILL.md +25 -0
  32. package/bundle/.cursorrules +0 -11
  33. package/bundle/AGENTS.md +0 -146
  34. package/bundle/gemini.md +0 -26
  35. package/bundle/rules/delivery-and-parallel-work.mdc +0 -26
  36. package/bundle/rules/git-commit.mdc +0 -24
  37. package/bundle/rules/multi-ai-workflow.mdc +0 -104
  38. package/bundle/rules.d/core-workflow.md +0 -48
  39. package/bundle/rules.d/deukrag-mcp.md +0 -37
  40. package/bundle/templates/MODULE_RULE_TEMPLATE.md +0 -24
  41. package/bundle/templates/TICKET_TEMPLATE.md +0 -58
  42. package/scripts/cli-ticket-logic.mjs +0 -568
  43. package/scripts/sync-bundle.mjs +0 -77
  44. package/scripts/sync-oss.mjs +0 -126
package/CHANGELOG.ko.md CHANGED
@@ -6,6 +6,80 @@
6
6
 
7
7
  형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 기반으로 하며, 이 프로젝트는 [유의적 버전(Semantic Versioning)](https://semver.org/spec/v2.0.0.html)을 준수합니다.
8
8
 
9
+ ## [3.3.2] - 2026-05-06
10
+
11
+ ### 포지셔닝 (Positioning)
12
+
13
+ - npm/GitHub에서 보이는 정체성을 **모든 레포를 위한 AI 코딩 에이전트 가드레일**로 재정리했습니다.
14
+ - `AGENTS.md`, Copilot instructions, Cursor rules, Claude skills, 에이전트 실행기, 일반 LLM/MCP 가드레일과 비교해 DeukAgentRules가 더하는 티켓 생명주기, 범위 계약, 검증, 아카이브 가능한 기억을 README에 드러냈습니다.
15
+ - 다음 개선 방향으로 첫 실행 점검, CLI/RAG 재각인 신호, active ticket/phase/open ticket count/DeukAgentContext memory status를 보여주는 companion 표면을 명시했습니다.
16
+
17
+ ## [3.3.0] - 2026-05-02
18
+
19
+ ### 추가됨 (Added)
20
+
21
+ - **docs:** VS Code, Open VSX, GitHub, skill 기반 발견 루프를 포함한 AI 코딩 에이전트 가드레일 포지셔닝, 비전, 오가닉 유입 리서치 문서를 추가했습니다.
22
+ - **docs:** Karpathy식 skill, DeukAgentRules, DeukAgentContext 심층 비교 문서를 추가했습니다. Skill은 행동 playbook, DeukAgentRules는 workflow/permission control, DeukAgentContext는 ticketed engineering memory로 포지셔닝했습니다.
23
+ - **seo:** `andrej-karpathy-skills` 관련 아이디어 링크와 Claude Code, AGENTS.md, Cursor rules, agent skills, AI guardrails 검색 유입 키워드를 보강했습니다.
24
+
25
+ ### 변경됨 (Changed)
26
+
27
+ - **ticket:** 열린 티켓이 설정된 한도를 넘을 때 자동 정리 대신 사용자가 목록을 보고 결정할 수 있는 cleanup flow를 강화했습니다.
28
+ - **ticket:** 닫힌 티켓은 자동 아카이브할 수 있게 하고, 아카이브된 티켓은 년월/일 단위로 정리되도록 했습니다.
29
+ - **docs:** README 문서 목록과 GitHub topic 가이드를 agent guardrail, instruction hub, skill registry, project memory 포지셔닝에 맞게 갱신했습니다.
30
+
31
+ ### 수정됨 (Fixed)
32
+
33
+ - **ticket:** 새 작업 진입 전에 정리 결정을 노출하여 열린 티켓 수가 의도한 운영 한도를 조용히 넘는 문제를 방지했습니다.
34
+
35
+ ## [3.2.0] - 2026-04-29
36
+
37
+ ### 추가됨 (Added)
38
+ - **agent:** 플랫폼 공존(Platform Coexistence) 및 모드 인지형(Mode-aware) 워크플로우 구현. (Plan Mode에서 TDW Phase 자동 매핑, `platform-coexistence.md` 규칙 추가, 수정 제어 및 `PROJECT_RULE.md` 포인터 연동 등)
39
+
40
+ ### 변경됨 (Changed)
41
+ - **agents:** Co-existence Protocol 및 Workflow Gate 기능 도입 (T-120).
42
+ - v3.1.0 아키텍처 원칙 및 사용법 문서 개선.
43
+
44
+ ## [3.1.0] - 2026-04-28
45
+
46
+ ### 추가됨 (Added)
47
+ - **arch:** 제로카피(Zero-Copy) 포인터 아키텍처 도입 (`PROJECT_RULE.md` 연동) 및 구조 간소화
48
+ - **cli:** 엄격한 Phase 기반 티켓 워크플로우 및 APC(Agent Permission Contract) 검증 기능 추가
49
+ - **cli:** `--plan-body` 옵션을 통한 채워진 Phase 1 티켓 본문 입력 기능 추가
50
+ - **ticket:** 티켓 아카이브 시 불필요한 토큰 낭비를 막는 Zero-Token 지식 증류(Knowledge Distillation) 구현
51
+ - **telemetry:** 로컬 환경에 최적화된 Telemetry CLI 추가
52
+ - **rules:** `PROJECT_RULE.md` 템플릿 추가 (AI 에이전트 폴백 가이드 포함) 및 이중 언어(한/영) 지원
53
+
54
+ ### 수정됨 (Fixed)
55
+ - **rules:** `PROJECT_RULE.md` 내 중복된 코어 룰 링크 제거 및 Frontmatter 렌더링 복구
56
+ - **telemetry:** 모델 및 설정에서 클라이언트 도구를 자동으로 감지하도록 수정
57
+ - **agent:** 티켓 탐색 중 에이전트 무한 루프 문제 해결
58
+
59
+ ### 변경됨 (Changed)
60
+ - **agent:** TDD 용어를 TDW (Ticket-Driven Workflow)로 변경 및 전역 `AGENTS.md`에서 낡은 규칙 제거
61
+ - **cli:** 상태 기반(State-driven) 경로 탐색 로직으로 구조 개편 및 상세한 사용 가이드 추가
62
+
63
+ ## [3.0.0] - 2026-04-25
64
+
65
+ ### 🚀 대규모 업데이트: Hub-Spoke 아키텍처
66
+ - **Canonical Rule Hub**: 모든 AI 에이전트의 단일 진실 공급원(SSOT)으로 `AGENTS.md` 도입.
67
+ - **Thin Spoke Pointers**: IDE별 룰(Cursor, Copilot 등)을 중앙 Hub를 가리키는 가벼운 포인터로 변경하여 중복 및 동기화 오류 제거.
68
+ - **Global CLI Proxy**: 로컬 워크스페이스 소스를 자동 감지하여 실행을 위임하는 프록시 도입으로 지연 없는(Zero-latency) 개발 환경 구축.
69
+
70
+ ### 🧹 제로 레거시 & 환경 정리
71
+ - **Auto-Purge**: `init` 실행 시 더 이상 사용되지 않는 레거시 `.cursorrules` 파일을 무조건 삭제.
72
+ - **Smart Backups**: 사용자 정의 규칙을 감지하여 삭제 대신 `.bak` 파일로 백업하는 로직 추가.
73
+ - **Submodule Scrubbing**: 비어 있는 서브모듈 디렉터리 스텁 및 `.gitmodules` 자동 정리 기능.
74
+
75
+ ### 🏗️ 리브랜딩 & 인프라스텍
76
+ - **Identity Overhaul**: "Zero-Latency, High-Signal AI Orchestration Protocol"로 리브랜딩.
77
+ - **Documentation v3**: 고품질 3D 인포그래픽 및 구조, 원리, 작동 방식 등 개념 가이드 전면 개편.
78
+ - **Domain Agnostic**: 도메인별 하드코딩을 제거하고 모든 기술 스택을 지원하도록 `bundle/AGENTS.md` 일반화.
79
+
80
+ ### ⚙️ CLI 개선 사항
81
+ - **Proxy Routing**: `bin/deuk-agent-rule.js`가 디렉터리를 탐색하여 로컬 스크립트를 찾아 실행하도록 수정.
82
+ - **Synchronized IO**: CLI의 안정성을 높이기 위해 핵심 로직을 동기적 파일 시스템 연산으로 리팩터링.
9
83
  ## [2.4.6] - 2026-04-19
10
84
 
11
85
  ### 수정됨 (Fixed)
package/CHANGELOG.md CHANGED
@@ -4,357 +4,179 @@ All notable changes to this project will be documented in this file.
4
4
 
5
5
  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).
6
6
 
7
- ## [2.5.13] - 2026-04-22
8
-
9
-
10
- ### Added
11
-
12
- - implement RAG-Miss fallback rule, fix ticket template formatting, and ignore tmp dirs in submodule discovery
13
-
7
+ ## [3.3.2] - 2026-05-06
8
+
9
+ ### Positioning
10
+
11
+ - 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.
12
+ - Added README comparison against `AGENTS.md`, Copilot instructions, Cursor rules, Claude skills, agent harnesses, and general guardrail frameworks to show where DeukAgentRules sits in the ecosystem.
13
+ - 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.
14
+
15
+
16
+ ### Added
17
+
18
+ - AGENTS.md v12 + summary mandatory guard + PROJECT_RULE optimization
19
+ - **cli:** add 'ticket next' command for instant task discovery (T[#295](https://github.com/joygram/DeukAgentRules/issues/295))
20
+ - **cli:** enforce required frontmatter keys in lint:md (T-118)
21
+ - harden ticket paths and add DeukPack RAG schemas
22
+ - **migration:** add summary/planLink/caution auto-enrichment for legacy tickets
23
+ - Phase 0 search limiter - max 2 MCP calls, skip when context sufficient
24
+ - replace legacy fill-in-the-blank rule check with Version Gating and Task Relevance check
25
+ - **rules:** enforce hard guardrails, add hotfix protocol and urgency response
26
+ - **rules:** harden document boundary workflow
27
+ - **spoke:** add fill-in completion template for rule enforcement
28
+ - **T-114:** 1-CALL ticket discovery rule + CLI max call limits
29
+ - **T-115:** HARD BLOCK on write tools without active ticket
30
+ - **T-116:** auto-close stale tickets on ticket create + Phase 4 NEVER skip
31
+ - **T-116:** smart close based on checklist + phase state
32
+ - **ticket:** enforce filled create flow and phase1 status guard
33
+ - **ticket:** enforce open ticket cleanup flow
34
+ - **ticket:** partition archive index by month
14
35
 
15
- ### Changed
16
36
 
17
- - squash mermaid diagram changelog noise into single entry
37
+ ### Fixed
18
38
 
19
- ## [2.5.12] - 2026-04-22
39
+ - add Refactor Safety Guard and Halt-and-Replan hard rules
40
+ - agent degradation remediation — planLink, inline TDW, token optimization
41
+ - align ticket APC template with phase gate
42
+ - **docs:** correct frontmatter keys in AGENTS.md (remove fm_ prefix)
43
+ - **init:** deploy Antigravity spoke to project root AGENTS.md
44
+ - register legitimate DR-04/DR-05 exceptions and update PROJECT_RULE.md
45
+ - remove duplicate phase key in ticket template and repair broken tickets
46
+ - **rules:** announce active ticket at start
47
+ - **rules:** keep planlink free of progress checkboxes
48
+ - **rules:** make planlink capture agent analysis
49
+ - **rules:** separate ticket and plan content
50
+ - **spoke:** GLOBAL_AGENTS.md link text to actual filename AGENTS.md
51
+ - SSOT — init removes .deuk-agent/templates/ unconditionally (bundle is single source of truth)
52
+ - **T-116:** parallel-safe auto-close - only close activeTicketId, warn others
53
+ - **T-116:** replace auto-close with activeTicketId switch + warning
54
+ - **ticket:** honor project and submodule filters
55
+ - **ticket:** Sync close/archive status to frontmatter to prevent rebuild reversion
20
56
 
21
57
 
22
58
  ### Changed
23
59
 
24
- - squash mermaid diagram changelog noise into single entry
60
+ - add Dependency Integrity Guard (HARD RULE) to AGENTS.md
61
+ - add lite accessibility vision plan
62
+ - add skill positioning release notes
63
+ - add version frontmatter to AGENTS.md for rule loading optimization
64
+ - align bad examples with plan/archive convention
65
+ - archive bmt coordination ticket 142
66
+ - archive bmt frontmatter cleanup ticket 144
67
+ - archive bmt go ticket 140
68
+ - archive bmt java ticket 139
69
+ - archive bmt matrix ticket 133
70
+ - archive bmt rust ticket 141
71
+ - bump AGENTS.md to v15 and strengthen dependency guards
72
+ - clarify ticket creation flow
73
+ - document rationale for docs/plan and fix section numbering
74
+ - Enforce strict rules for Scope Creep Handling
75
+ - enhance main features and workflow intro for v3.2.0
76
+ - optimize AGENTS.md — merge Dependency Integrity into Refactor Guard, compress Scope Creep
77
+ - position agent guardrail growth loop
78
+ - **rules:** clarify phase one execution semantics
79
+ - **rules:** mandate enrich_frontmatter for all plan/report files (T-118)
80
+ - **spoke:** hard rule single directive
81
+ - update legacy path guidance to plan/archive layout
25
82
 
26
- ## [2.5.11] - 2026-04-22
83
+ ## [3.3.0] - 2026-05-02
27
84
 
28
85
  ### Added
29
86
 
30
- - implement modernized workflow diagrams with Mermaid v8.8.0 compatibility, semantic color palette, and native SVG text rendering for IDE dark mode compatibility
31
-
32
- ## [2.5.1] - 2026-04-22
33
-
34
- ### Added
35
-
36
- - **cli:** add --clean flag to init command for safe configuration reset
37
-
38
- ## [2.5.0] - 2026-04-22
39
-
40
- ### Added
41
-
42
- - Agent-Agnostic Workflow and Archiving Protocol
43
- - **cli:** parse DeukRag config for conditions and auto-scaffold plan templates
44
- - implement Frontmatter-driven modular rule assembly (Ticket 045)
45
- - Model-specific hard rules (gemini.md) and Continuous RAG enforcement
46
- - **rules:** enforce Phase 0 MCP RAG in multi-ai-workflow MDC
47
- - **rules:** harden post-mortem workflow and mandate follow-up chaining
48
- - **templates:** enforce Phase 0 RAG Research checklists in ticket template
49
-
50
-
51
- ### Fixed
52
-
53
- - handoff path format, 3-tier template system, recursive init with normalization
54
- - improve migration robustness with merging logic and cleanup dead code
55
- - recursive directory merge for legacy migration
56
-
87
+ - **docs:** add AI coding agent guardrail positioning, vision, and organic growth research for VS Code, Open VSX, GitHub, and skill-driven discovery.
88
+ - **docs:** add a deep comparison of Karpathy-style skills, DeukAgentRules, and DeukAgentContext, positioning skills as behavior playbooks, DeukAgentRules as workflow/permission control, and DeukAgentContext as ticketed engineering memory.
89
+ - **seo:** add related-project positioning for `andrej-karpathy-skills` plus discovery keywords for Claude Code, AGENTS.md, Cursor rules, agent skills, and AI guardrails.
57
90
 
58
91
  ### Changed
59
92
 
60
- - add ticket 045 completion report
61
- - add what's new for v2.4, RAG engine notice, and SEO keywords
62
- - **rules:** Add Fast-Track workflow to prevent ticket loop overhead
63
- - **rules:** enforce Continuous RAG Policy and Absolute MCP Priority
64
- - **rules:** Mandate Continuous RAG during execution and verification phases
65
- - **rules:** Restore TDD workflow but ban interactive CLI looping
66
- - upgrade workflow diagram and add migration troubleshooting guide
67
-
68
- ## [2.4.6] - 2026-04-19
93
+ - **ticket:** enforce a decision-first cleanup flow when open tickets exceed the configured limit, while allowing closed tickets to be archived automatically.
94
+ - **ticket:** organize archived tickets by year-month and day to reduce active ticket repository clutter.
95
+ - **docs:** update README document indexes and GitHub topic guidance to emphasize the agent guardrail, instruction hub, skill registry, and project memory positioning.
69
96
 
70
97
  ### Fixed
71
98
 
72
- - **cli:** suppress update notifier when local version is greater than or equal to registry version (fixes false-positive spam in local dev symlink environments)
73
- - **ticket:** cap `NNN` regex to 4 digits to prevent unix timestamps being incorrectly parsed as ticket sequential numbers, restoring correct `NNN-topic-hostname` format generation
99
+ - **ticket:** prevent open ticket growth from silently exceeding the intended operating limit by surfacing cleanup decisions before new work proceeds.
74
100
 
75
- ## [2.4.5] - 2026-04-18
101
+ ## [3.2.0] - 2026-04-28
102
+
103
+
104
+ ### Added
105
+
106
+ - **agent:** implement platform coexistence and mode-aware workflow
107
+
108
+
109
+ ### Changed
110
+
111
+ - **agents:** add Co-existence Protocol and Workflow Gate (T-120)
112
+ - update usage, architecture, and principles for v3.1.0
113
+
114
+ ## [3.1.0] - 2026-04-28
76
115
 
77
116
 
78
117
  ### Added
79
118
 
80
- - **cli:** add update notifier for checking latest npm version
119
+ - add ArchitectureGuard.test.mjs and create technical debt ticket T-103
120
+ - add first-class copilot and codex support
121
+ - **arch:** implement APC v3 and simplify repository structure
122
+ - **cli:** restrict --skip-phase0 based on MCP server status and update rules
123
+ - consolidate rule cleanup logic and enforce thin pointers for entry points
124
+ - enforce unidirectional AGENTS.md single source of truth
125
+ - enhance CLI reporting and add practical usage guide
126
+ - implement strict phase-driven ticket workflow with APC validation
127
+ - implement Zero-Copy architecture with absolute path pointing and frontmatter-based PROJECT_RULE.md
128
+ - implement zero-token knowledge distillation on ticket archive and cleanup dead code
129
+ - **rules:** add AI Agent fallback guide to PROJECT_RULE.md template
130
+ - **rules:** normalize canonical rules and decouple DeukPack rules
131
+ - **telemetry:** add local-first telemetry CLI and update AGENTS.md
132
+ - **ticket:** implement --plan-body for filled Phase 1 ticket body input and update project rules
81
133
 
82
134
 
83
135
  ### Fixed
84
136
 
85
- - **ticket:** resolve discrepancy between filename and ticket ID generation
86
- - **ticket:** strictly enforce 8-character limit on hostname slug
137
+ - auto-detect client tool from model and config in telemetry
138
+ - resolve agent loop on ticket navigation + archive 37 dead tickets
139
+ - **rules:** bilingual ko/en PROJECT_RULE.md template
140
+ - **rules:** remove redundant core rules link from PROJECT_RULE.md
141
+ - **rules:** restore frontmatter in PROJECT_RULE.md
142
+ - **rules:** restore mandatory ticket workflow and anti-shoveling rules
143
+ - **rules:** sync restored strict workflow AGENTS.md and unified templates
87
144
 
88
145
 
89
146
  ### Changed
90
147
 
91
- - add reasons for global installation
92
- - **changelog:** sync korean changelog with v2.4.0
93
- - generalize AGENTS.md and cleanup submodule-specific rules
94
- - **ticket:** new ID format NNN-topic-hostname with backward-compatible parsing
148
+ - add markdown lint policy and workflow docs
149
+ - **agent:** rename TDD to TDW, archive ticket 101, and remove DOMAIN_RULES
150
+ - AGENTS.md full cleanup - eliminate redundancy, unify English, remove dead rules
151
+ - finalize ticket 066 rule normalization
152
+ - modernize CLI architecture, implement state-driven path resolution, and comprehensive audit cleanup
153
+ - **rules:** decouple DeukPack rules and fix merge injection logic
154
+ - update principles and cli compiler to DeukAgentContext
95
155
 
96
- ## [2.4.4] - 2026-04-19
97
-
98
- ### Changed
99
-
100
- - **rules:** generalize `AGENTS.md` by moving submodule-specific rules (DeukPack, C++, Unity) to their respective workspace `MODULE_RULE.md` files
101
- - **templates:** cleanup legacy templates in `bundle/` to match `publish/` source
102
-
103
- ## [2.4.3] - 2026-04-18
104
-
105
- ### Changed
106
-
107
- - **ticket:** new ID format `NNN-topic-hostname` (e.g. `001-add-feature-joy-nucb`) replacing legacy `ticket_NNN_hostname_topic` format
108
- - **ticket:** backward-compatible parsing supports both old and new formats in INDEX.json
156
+ ## [3.0.0] - 2026-04-25
109
157
 
110
- ## [2.4.2] - 2026-04-18
158
+ ### 🚀 Major Breakthrough: Hub-Spoke Architecture
159
+ - **Canonical Rule Hub**: Introduced `AGENTS.md` as the single source of truth for all AI agents.
160
+ - **Thin Spoke Pointers**: IDE-specific rules (Cursor, Copilot, etc.) are now lightweight pointers to the central Hub, eliminating duplication and sync errors.
161
+ - **Global CLI Proxy**: Implemented a smart entry point that automatically detects and routes execution to local workspace sources, ensuring zero-latency development.
111
162
 
163
+ ### 🧹 Zero-Legacy & Cleanliness
164
+ - **Auto-Purge**: `init` now unconditionally deletes deprecated `.cursorrules` files.
165
+ - **Smart Backups**: Added logic to detect custom user rules and rename files to `.bak` instead of deletion.
166
+ - **Submodule Scrubbing**: Automatically cleans empty submodule directory stubs and scrubs `.gitmodules`.
112
167
 
113
- ### Added
114
-
115
- - **cli:** add update notifier for checking latest npm version
116
-
168
+ ### 🏗️ Branding & Infrastructure
169
+ - **Identity Overhaul**: Rebranded as a "Zero-Latency, High-Signal AI Orchestration Protocol".
170
+ - **Documentation v3**: New high-end 3D visual infographics and overhauled conceptual guides (Architecture, Principles, How-it-works).
171
+ - **Domain Agnostic**: Generalized `bundle/AGENTS.md` to support any technology stack, removing domain-specific hardcoding.
117
172
 
118
- ### Fixed
119
-
120
- - **ticket:** resolve discrepancy between filename and ticket ID generation
121
- - **ticket:** strictly enforce 8-character limit on hostname slug
173
+ ### ⚙️ CLI Enhancements
174
+ - **Proxy Routing**: `bin/deuk-agent-rule.js` performs directory traversal to find local scripts.
175
+ - **Synchronized IO**: Refactored core logic to use synchronous FS operations for rock-solid CLI stability.
122
176
 
123
-
124
- ### Changed
125
-
126
- - add reasons for global installation
127
- - **changelog:** sync korean changelog with v2.4.0
128
-
129
- ## [2.4.1] - 2026-04-18
130
-
131
-
132
- ### Added
133
-
134
- - **cli:** add update notifier for checking latest npm version
135
-
136
-
137
- ### Fixed
138
-
139
- - **ticket:** strictly enforce 8-character limit on hostname slug
140
-
141
-
142
- ### Changed
143
-
144
- - add reasons for global installation
145
- - **changelog:** sync korean changelog with v2.4.0
177
+ ---
146
178
 
147
179
  ## [2.4.0] - 2026-04-18
148
-
149
-
150
- ### Added
151
-
152
- - **init:** add obsolete template cleanup for cleaner migration
153
- - **rules:** add TICKET VERIFICATION RULE to original agents.md
154
- - **ticket:** add priority property to tickets
155
- - **ticket:** add sequential hostname-aware ticket naming (NNN-hostname-topic)
156
- - **ticket:** auto-sequence numbering and hostname-based naming (limit 8 chars)
157
-
158
-
159
- ### Fixed
160
-
161
- - **rules:** force use of local latest deuk-agent-rule to avoid npx cache issues
162
- - **scripts:** correct log output for OSS repository url example
163
-
164
-
165
- ### Changed
166
-
167
- - add Step 4 (Ticket Verification) to README files
168
- - clarify global installation and OS-specific permissions
169
- - enforce ticket reference in implementation artifacts
170
-
171
- ## [2.3.2] - 2026-04-17
172
-
173
-
174
- ### Fixed
175
-
176
- - **cli:** resolve `ERR_MODULE_NOT_FOUND` in distributed environments by fixing hardcoded `yaml` dependency path
177
- - **dependencies:** add `yaml` to explicit dependencies list
178
-
179
- ## [2.3.1] - 2026-04-17
180
-
181
-
182
- ### Changed
183
-
184
- - **readme:** add changelog and automated release instructions
185
-
186
- ## [2.3.0] - 2026-04-17
187
-
188
-
189
- ### Added
190
-
191
- - Advance AI pipeline integration and optional synchronization system
192
- - **cli:** add --submodule filter to ticket list command
193
- - **cli:** restore ticket archive and reports workflows to modular architecture
194
- - **rules:** advance rules for Unity Client, WebApp, and C++ Server hybrid environment
195
- - **ticket:** implementation of decentralized ticket management & sharing policy
196
- - **ticket:** upgrade to V2 YAML Front-matter and Categorized List
197
-
198
-
199
- ### Fixed
200
-
201
- - **ticket:** deprecate LATEST.md, unify pointer to ACTIVE_TICKET.md
202
- - **ticket:** resolve issue where active tickets were not listed for DeukAgentRules repo
203
-
204
-
205
- ### Changed
206
-
207
- - **readme:** clarify YAML front matter preservation and distributed ticket workflow for v2.2.2
208
- - **readme:** restore count headers and npm badges
209
- - **rules:** enforce CLI usage for ticket reading to prevent manual JSON parsing
210
- - Update CLI reference with close and migrate commands
211
-
212
- ## [1.0.18] - 2026-04-12
213
-
214
-
215
- ### Added
216
-
217
- - **ai:** map conversational ticket requests to implicit CLI execution
218
- - **cli:** implement ticket archive and reporting workflow
219
- - **rules:** map conversational ticket aliases to implicit CLI execution
220
-
221
-
222
- ### Changed
223
-
224
- - **readme:** add ticket archive and reports CLI usage to documentation
225
- - **readme:** describe natural language CLI prompting alternatives
226
- - **readme:** provide explicit conversational prompt examples inside option tables
227
- - **readme:** provide explicit update guide
228
- - **rules:** add prompting guide and execution report archival rule
229
-
230
- ## [1.0.17] - 2026-04-06
231
-
232
-
233
- ### Fixed
234
-
235
- - **template:** move ticket repo-relative marker to bottom
236
-
237
- ## [1.0.16] - 2026-04-05
238
-
239
-
240
- ### Added
241
-
242
- - **workflow:** add auto-verification and final report to agent workflows
243
-
244
- ## [1.0.15] - 2026-04-05
245
-
246
-
247
- ### Added
248
-
249
- - Migrate and rename handoff terminology to ticket in CLI and templates
250
-
251
-
252
- ### Changed
253
-
254
- - Add strict rule for DeukPack namespace requirement
255
- - Completely eradicate legacy Handoff references from AGENTS.md, templates, and mdc rules
256
- - Enforce DeukPack code format and API strictly as a hard rule
257
- - Refactor README usage guide and workflow
258
-
259
- ## [1.0.14] - 2026-04-02
260
-
261
-
262
- ### Added
263
-
264
- - **cli:** extend merge tooling and sync publish docs
265
- - **rules:** forbid 'sync' word in commit titles in agent rules
266
- - **handoff:** add indexed handoff workflow and CLI
267
- - **architecture:** migrate template architecture to zero-touch NPM bundle scaffolding
268
-
269
-
270
- ### Fixed
271
-
272
- - **cli:** resolve html entity syntax error in template generator
273
-
274
-
275
- ### Changed
276
-
277
- - **docs:** public-facing RELEASING and changelog wording; sync-bundle comment
278
- - **docs:** update README with token efficiency mechanism and zero-touch template scaffolding
279
-
280
- ## [1.0.13] - 2026-03-28
281
-
282
-
283
- ### Fixed
284
-
285
- - **deuk-agent-rule:** `printHandoffTip` missing in CLI (handoff tip after `init`)
286
-
287
-
288
- ### Changed
289
-
290
- - **docs:** README § Handoffs; GitHub About text; npm keywords; CLI survey adds Claude, Windsurf, JetBrains AI Assistant
291
- - **agents:** optional `.cursor/plans/*.plan.md` mirror for plan-style UI; chat `Path:` line and optional first-line path in handoff files
292
- - **deuk-agent-rule:** `init` prints a short handoff tip after ensuring `.deuk-agent-handoff/`
293
- - **deuk-agent-rule:** default `--rules prefix` overwrites existing `deuk-agent-rule-*.mdc` on repeat `init` (package updates without a separate `merge`)
294
- - **deuk-agent-rule:** `.deuk-agent-rule.config.json` stores interactive choices; later `init` reuses them (`--interactive` to change; `--non-interactive` for CI only)
295
-
296
-
297
- ## [1.0.12] - 2026-03-27
298
-
299
-
300
- ### Fixed
301
-
302
- - **ci:** release workflow runs on pushes to `master`
303
-
304
- ### Changed
305
-
306
- - **agents:** require full repo-root paths for handoff file links
307
-
308
- ## [1.0.11] - 2026-03-26
309
-
310
-
311
- ### Added
312
-
313
- - **ci:** GitHub Release workflow for version tags and `chore(release):` commits on `main` / `master`
314
-
315
- ## [1.0.10] - 2026-03-26
316
-
317
-
318
- ### Added
319
-
320
- - **deuk-agent-rule:** changelog template headers without per-commit links
321
-
322
- ## [1.0.9] - 2026-03-27
323
-
324
- ### Added
325
-
326
- - **deuk-agent-rule:** release changelog tooling; handoff directory gitignore; pre-work handoff scan; AGENTS inject newline fix
327
-
328
- ### Changed
329
-
330
- - **agents:** DeukAgentRules/handoff/LATEST.md handoff path for consumer repos
331
-
332
- ## [1.0.8] - 2026-03-27
333
-
334
- ### Added
335
-
336
- - This changelog and npm `files` entry so releases are traceable.
337
-
338
- ## [1.0.7] - 2026-03-27
339
-
340
- ### Added
341
-
342
- - `init`: create `.deuk-agent-handoff/` and append `.gitignore` rules for local handoffs.
343
- - CLI: pre-work handoff scan; `publish/AGENTS.md` and `multi-ai-workflow.mdc` updates.
344
-
345
- ### Fixed
346
-
347
- - AGENTS tagged-region merge: trailing newline after injected blocks.
348
-
349
- ## [1.0.5] - 2026-03-26
350
-
351
- ### Changed
352
-
353
- - README and package metadata (Deuk Family tagline, npm keywords, GitHub Topics note).
354
-
355
- ## [1.0.4] - 2026-03-26
356
-
357
- ### Changed
358
-
359
- - Release packaging includes `package-lock.json` for reproducible installs.
360
- - README: absolute links for the npm package page.
180
+ - add Codex CLI support (.codexrules) and apply globally
181
+ - implement ticket chaining (--chain) for automated ticket linkage
182
+ - improve submodule isolation logic