deuk-agent-rule 2.5.11 → 2.5.14

package/CHANGELOG.md

@@ -4,11 +4,37 @@ 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.5.14] - 2026-04-22
+
+
+### Fixed
+
+- **cli:** resolve marker nesting bug in AGENTS.md injection
+
+## [2.5.13] - 2026-04-22
+
+
+### Added
+
+-  implement RAG-Miss fallback rule, fix ticket template formatting, and ignore tmp dirs in submodule discovery
+
+
+### Changed
+
+-  squash mermaid diagram changelog noise into single entry
+
+## [2.5.12] - 2026-04-22
+
+
+### Changed
+
+-  squash mermaid diagram changelog noise into single entry
+
 ## [2.5.11] - 2026-04-22
 
-### Changed
+### Added
 
-- modernize workflow diagram with Mermaid v8.8.0-compatible syntax, semantic color palette, and native SVG text rendering for IDE dark mode compatibility
+- implement modernized workflow diagrams with Mermaid v8.8.0 compatibility, semantic color palette, and native SVG text rendering for IDE dark mode compatibility
 
 ## [2.5.1] - 2026-04-22
 

package/bundle/rules.d/deukrag-mcp.md

@@ -29,3 +29,9 @@ inject_target: ["AGENTS.md", "gemini.md"]
 ### State C: RAG-Error (Loop Prevention)
 - **상태**: MCP 호출 시 타임아웃, 연결 오류, 또는 동일 에러가 2회 이상 반복됨.
 - **행동**: **즉시 RAG 호출을 중단**하고 State B(로컬 검색)로 강제 전환하십시오. 에러 루프에 빠져 작업 시간을 낭비하지 마십시오. 문제 상황을 `## 📜 Execution Report`에 기록하여 추후 복구 티켓을 발행할 수 있게 하십시오.
+
+### State D: RAG-Miss (Zero Results)
+- **상태**: MCP 도구를 정상 호출했으나 관련 결과가 반환되지 않음 (DeukRag Miss).
+- **행동**: 검색 결과가 없다고 해서 임의로 추측하거나 단념하지 마십시오. 즉시 로컬 파일 기반 검색(`grep_search`, `list_dir`, `view_file`)으로 전환하여 대체 로컬 근거(Local Evidence)를 수집하십시오.
+  - **[보완 하드룰]**: 로컬 검색으로 찾은 대체 근거는 즉시 `add_knowledge` 도구를 호출하여 RAG 시스템에 보완(주입)하십시오. 이를 통해 다음 질의부터 해당 지식을 즉시 검색할 수 있게 됩니다.
+  - **이후 티켓이나 보고서 작성 시 반드시 "RAG Miss 발생: 로컬 검색 근거 파일 목록[...]"을 명시적으로 기록하십시오.**

package/bundle/templates/TICKET_TEMPLATE.md

@@ -29,17 +29,23 @@
    - [ ] `mcp_deukrag_search_rules` 기반 규약 검토 완료
    - [ ] `mcp_deukrag_search_tickets` 과거 유사 티켓 이력 열람 완료
    - [ ] (필수 작성) 검색된 핵심 컨텍스트 요약: 
+   - [ ] (RAG Miss 시 필수 작성) 로컬 검색 결과 `add_knowledge` 도구로 즉시 주입 완료 여부 및 주입된 파일 목록: 
+
 0.5 [Phase 0.5> Deep Analysis (Optional)]
    - [ ] 복잡한 아키텍처 변경 시 별도 분석 아티팩트 작성 및 승인 완료
+
 1. [Phase 1> Setup / Parsing]
+
 2. [Phase 2> Core Logic Change]
    - [ ] (CONTINUOUS RAG) 새로운 함수/클래스 수정 전 `mcp_deukrag_search_code` 및 `search_rules`로 관련 패턴 수시 검색
+
 3. [Phase 3> Cleanup / Verification]
    - [ ] (VERIFY RAG) 디버깅 및 에러 발생 시 로그 덤프 전 `mcp_deukrag_search_tickets` 로 과거 해결책 우선 탐색
    - [ ] **Potential Issue Table**:
      | 이슈 | 심각도 | 설명 | 조치 계획 |
      |---|---|---|---|
      | | | | |
+
 4. [Phase 4> Follow-up Chaining (MANDATORY if issues exist)]
    - [ ] 위 표에서 즉시 해결 불가능한 항목에 대해 별도 티켓 발행 완료
      > CLI Command Example: `deuk-agent-rule ticket create --topic 048-F1-fix-issue --title "Fix the issue" --group <group>`

package/package.json

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

package/scripts/cli-init-commands.mjs

@@ -215,7 +215,9 @@ function deploySpokePointers(cwd, dryRun) {
 }
 
 export async function runInit(opts, bundleRoot) {
-  const submodules = discoverAllSubmodules(opts.cwd);
+  const savedConfig = loadInitConfig(opts.cwd) || {};
+  const ignoreDirs = savedConfig.ignoreDirs;
+  const submodules = discoverAllSubmodules(opts.cwd, ignoreDirs);
   if (!submodules.includes(opts.cwd)) submodules.push(opts.cwd);
 
   const markers = resolveMarkers(opts);

package/scripts/cli-utils.mjs

@@ -57,6 +57,7 @@ export function writeInitConfig(cwd, opts) {
     shareTickets: !!opts.shareTickets,
     remoteSync: !!opts.remoteSync,
     pipelineUrl: opts.pipelineUrl,
+    ignoreDirs: opts.ignoreDirs || DEFAULT_IGNORE_DIRS,
     updatedAt: new Date().toISOString(),
   };
   writeFileSync(p, JSON.stringify(data, null, 2), "utf8");
@@ -209,10 +210,12 @@ export async function checkUpdateNotifier() {
   }
 }
 
+export const DEFAULT_IGNORE_DIRS = ["node_modules", ".git", ".deuk-agent", "tmp", "temp", ".tmp", ".cache"];
+
 /**
  * Recursively finds all directories containing deuk-agent ticket structures.
  */
-export function discoverAllSubmodules(baseCwd, out = new Set()) {
+export function discoverAllSubmodules(baseCwd, ignoreDirs = DEFAULT_IGNORE_DIRS, out = new Set()) {
   if (!existsSync(baseCwd)) return Array.from(out);
 
   const hasLegacy1 = existsSync(join(baseCwd, ".deuk-agent-ticket"));
@@ -227,9 +230,9 @@ export function discoverAllSubmodules(baseCwd, out = new Set()) {
     const entries = readdirSync(baseCwd, { withFileTypes: true });
     for (const ent of entries) {
       if (!ent.isDirectory()) continue;
-      // Skip system or noisy directories
-      if (ent.name === "node_modules" || ent.name === ".git" || ent.name === AGENT_ROOT_DIR || ent.name.startsWith(".deuk-agent")) continue;
-      discoverAllSubmodules(join(baseCwd, ent.name), out);
+      // Skip system or noisy directories based on ignoreDirs configuration
+      if (ignoreDirs.includes(ent.name) || ent.name.startsWith(".deuk-agent")) continue;
+      discoverAllSubmodules(join(baseCwd, ent.name), ignoreDirs, out);
     }
   } catch {
     // Ignore permission errors on specific subfolders

package/scripts/merge-logic.mjs

@@ -41,11 +41,27 @@ export function resolveMarkers(o) {
   };
 }
 
+/**
+ * Strip all internal begin/end marker lines from content.
+ * Preserves only the content between markers without nesting.
+ */
+export function stripInternalMarkers(content, begin, end) {
+  return content
+    .split('\n')
+    .filter(line => {
+      const t = line.trim();
+      return t !== begin && t !== end;
+    })
+    .join('\n');
+}
+
 export function findMarkerRegion(content, begin, end) {
   const i = content.indexOf(begin);
   if (i === -1) return null;
-  const j = content.indexOf(end, i + begin.length);
-  if (j === -1) {
+  // Use lastIndexOf to match the outermost end marker,
+  // preventing nested markers from causing partial replacement.
+  const j = content.lastIndexOf(end);
+  if (j === -1 || j <= i) {
     throw new Error(
       `[MARKER ERROR] Found begin marker "${begin}" but no matching end marker "${end}" after it.\n` +
       `  This usually happens if one marker was deleted or renamed manually. Please verify the target file.`
@@ -120,8 +136,10 @@ function handleAgentOverwrite(opts) {
 }
 
 function handleAgentInject(opts, existing, region) {
-  const { targetPath, bundleContent, dryRun, backup } = opts;
-  const inner = bundleContent.trimEnd() + "\n";
+  const { targetPath, bundleContent, markers, dryRun, backup } = opts;
+  // Strip any internal begin/end markers from bundle content to prevent nesting
+  const cleanContent = stripInternalMarkers(bundleContent, markers.begin, markers.end);
+  const inner = cleanContent.trimEnd() + "\n";
   const next = existing.slice(0, region.innerStart) + "\n" + inner + existing.slice(region.innerEnd);
   if (dryRun) {
     return { action: "would-write", path: targetPath, mode: "inject-region" };