deuk-agent-rule 2.4.1 → 2.4.3

package/CHANGELOG.ko.md

@@ -6,6 +6,17 @@
 
 형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 기반으로 하며, 이 프로젝트는 [유의적 버전(Semantic Versioning)](https://semver.org/spec/v2.0.0.html)을 준수합니다.
 
+## [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)

package/CHANGELOG.md

@@ -4,48 +4,74 @@ 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).
 
-## [2.4.1] - 2026-04-18
-
-
-### Added
-
-- **cli:** add update notifier for checking latest npm version
-
-
-### Fixed
-
-- **ticket:** strictly enforce 8-character limit on hostname slug
-
-
-### Changed
-
--  add reasons for global installation
-- **changelog:** sync korean changelog with v2.4.0
-
-## [2.4.0] - 2026-04-18
-
-
-### Added
-
-- **init:** add obsolete template cleanup for cleaner migration
-- **rules:** add TICKET VERIFICATION RULE to original agents.md
-- **ticket:** add priority property to tickets
-- **ticket:** add sequential hostname-aware ticket naming (NNN-hostname-topic)
-- **ticket:** auto-sequence numbering and hostname-based naming (limit 8 chars)
-
-
-### Fixed
-
-- **rules:** force use of local latest deuk-agent-rule to avoid npx cache issues
-- **scripts:** correct log output for OSS repository url example
-
-
-### Changed
-
--  add Step 4 (Ticket Verification) to README files
--  clarify global installation and OS-specific permissions
--  enforce ticket reference in implementation artifacts
-
+## [2.4.3] - 2026-04-18
+
+### Changed
+
+- **ticket:** new ID format `NNN-topic-hostname` (e.g. `001-add-feature-joy-nucb`) replacing legacy `ticket_NNN_hostname_topic` format
+- **ticket:** backward-compatible parsing supports both old and new formats in INDEX.json
+
+## [2.4.2] - 2026-04-18
+
+
+### Added
+
+- **cli:** add update notifier for checking latest npm version
+
+
+### Fixed
+
+- **ticket:** resolve discrepancy between filename and ticket ID generation
+- **ticket:** strictly enforce 8-character limit on hostname slug
+
+
+### Changed
+
+-  add reasons for global installation
+- **changelog:** sync korean changelog with v2.4.0
+
+## [2.4.1] - 2026-04-18
+
+
+### Added
+
+- **cli:** add update notifier for checking latest npm version
+
+
+### Fixed
+
+- **ticket:** strictly enforce 8-character limit on hostname slug
+
+
+### Changed
+
+-  add reasons for global installation
+- **changelog:** sync korean changelog with v2.4.0
+
+## [2.4.0] - 2026-04-18
+
+
+### Added
+
+- **init:** add obsolete template cleanup for cleaner migration
+- **rules:** add TICKET VERIFICATION RULE to original agents.md
+- **ticket:** add priority property to tickets
+- **ticket:** add sequential hostname-aware ticket naming (NNN-hostname-topic)
+- **ticket:** auto-sequence numbering and hostname-based naming (limit 8 chars)
+
+
+### Fixed
+
+- **rules:** force use of local latest deuk-agent-rule to avoid npx cache issues
+- **scripts:** correct log output for OSS repository url example
+
+
+### Changed
+
+-  add Step 4 (Ticket Verification) to README files
+-  clarify global installation and OS-specific permissions
+-  enforce ticket reference in implementation artifacts
+
 ## [2.3.2] - 2026-04-17
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deuk-agent-rule",
-  "version": "2.4.1",
+  "version": "2.4.3",
   "description": "DeukAgentRules: generic AGENTS.md + .cursor rule templates with init/merge CLI (npm name: deuk-agent-rule).",
   "keywords": [
     "agents-md",

package/scripts/cli-ticket-commands.mjs

@@ -33,31 +33,14 @@ export async function runTicketCreate(opts) {
     // Find nearest or create in CWD if missing
     const ticketDir = detectConsumerTicketDir(opts.cwd, { createIfMissing: true });
     
-    // Calculate next sequence number by scanning existing files
-    let maxSeq = 0;
-    const allFiles = [];
-    const scanDirs = [join(ticketDir, "sub"), join(ticketDir, "main"), join(ticketDir, "archive/sub"), join(ticketDir, "archive/main")];
-    for (const d of scanDirs) {
-      if (existsSync(d)) {
-        const files = readdirSync(d);
-        for (const f of files) {
-          const match = f.match(/^(\d+)-/);
-          if (match) {
-            const num = parseInt(match[1], 10);
-            if (num > maxSeq) maxSeq = num;
-          }
-        }
-      }
-    }
-    const nextSeq = String(maxSeq + 1).padStart(3, "0");
-    const hName = hostname().toLowerCase().slice(0, 8);
-    const finalFileName = `${nextSeq}-${hName}-ticket-${topic}.md`;
+    const indexJson = readTicketIndexJson(opts.cwd);
+    const ticketId = generateTicketId(topic, indexJson.entries);
+    const finalFileName = `${ticketId}.md`;
 
     const abs = join(ticketDir, group, finalFileName);
     mkdirSync(join(ticketDir, group), { recursive: true });
     path = toRepoRelativePath(opts.cwd, abs);
 
-    const ticketId = generateTicketId(title);
     const meta = {
       id: ticketId,
       title,

package/scripts/cli-ticket-logic.mjs

@@ -190,7 +190,7 @@ export function performUpgradeMigration(cwd, opts = {}) {
     const project = meta.project || detectProjectFromBody(content);
     
     const newMeta = {
-      id: meta.id || `ticket_${statSync(abs).mtimeMs}`,
+      id: meta.id || `000-legacy-${statSync(abs).mtimeMs}`,
       title,
       status,
       submodule: meta.submodule || (content.includes("DeukPack") ? "DeukPack" : ""),
@@ -486,20 +486,23 @@ export function getHostnameSlug() {
 
 /**
  * Computes next sequential 3-digit ticket number by scanning all entries
- * in the current INDEX.json for IDs matching `ticket_NNN_*`.
- * Safe to call cross-device: each hostname produces an independent sequence,
- * but the number is always calculated from the current local INDEX state.
+ * in the current INDEX.json. Parses both legacy (`ticket_NNN_*`) and
+ * new (`NNN-topic-hostname`) formats for backward compatibility.
  *
  * @param {object[]} existingEntries - entries array from INDEX.json
  * @returns {{ num: number, hostname: string }}
  */
 export function computeNextTicketNumber(existingEntries) {
   const hostname = getHostnameSlug();
-  // Match both old format `ticket_NNN_hostname_*` and new `ticket_NNN_*`
-  const numRe = /^ticket_(\d{3,})_/;
+  // Legacy: ticket_NNN_*  |  New: NNN-*
+  const legacyRe = /^ticket_(\d{3,})_/;
+  const newRe = /^(\d{3,})-/;
   let max = 0;
   for (const e of (existingEntries || [])) {
-    const m = String(e.id || '').match(numRe);
+    const id = String(e.id || '');
+    const mLegacy = id.match(legacyRe);
+    const mNew = id.match(newRe);
+    const m = mLegacy || mNew;
     if (m) {
       const n = parseInt(m[1], 10);
       if (n > max) max = n;
@@ -510,7 +513,8 @@ export function computeNextTicketNumber(existingEntries) {
 
 /**
  * Sequential hostname-aware ticket ID.
- * Format: ticket_NNN_<hostname>_<topic-slug>
+ * Format: NNN-<topic-slug>-<hostname>
+ * Example: 001-add-feature-joy-nucb
  * NNN starts at 001 and increments per local INDEX.json state.
  *
  * @param {string} topicSlug
@@ -520,7 +524,7 @@ export function generateTicketId(topicSlug, existingEntries) {
   const { num, hostname } = computeNextTicketNumber(existingEntries);
   const numStr = String(num).padStart(3, '0');
   const slug = toSlug(topicSlug || 'ticket').slice(0, 32);
-  return `ticket_${numStr}_${hostname}_${slug}`;
+  return `${numStr}-${slug}-${hostname}`;
 }
 
 /**

package/scripts/cli-utils.mjs

@@ -73,7 +73,7 @@ export function formatTimestampForFile(d = new Date()) {
 }
 
 export function makeEntryId() {
-  return `ticket_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+  return `000-fallback-${Date.now().toString(36)}`;
 }
 
 export function detectProjectFromBody(body) {