deuk-agent-flow 4.0.36 → 4.2.7

package/CHANGELOG.ko.md

@@ -10,7 +10,36 @@
 
 ### 수정됨 (Fixed)
 
+- **ticket:** 티켓 템플릿의 APC 마커를 추가 설명문 없이 제목형으로 정리해, 에이전트가 마커 본문을 다음 줄에 쓰도록 유도했습니다.
+- **ticket:** APC create 입력을 마커별로 자르지 않고 APC 섹션 전체 기준으로 검증해, 제목형·단독형·inline 마커 스타일 호환성을 유지했습니다.
+- **rules:** `Ticket start` 링크가 이미 노출된 티켓은 완료 응답에서 같은 클릭 링크를 다시 내보내지 않도록 했습니다.
+- **skills:** 공용 skill 요약과 ownership 문구에서 DeukAgentFlow 전용 표현을 제거해 소비자 표면을 일반화했습니다.
+
+## [4.2.2] - 2026-05-10
+
+### 수정됨 (Fixed)
+
+- **release:** 버전 bump 시 `Unreleased`에 남은 항목이 유실되지 않도록 누적 릴리스 이월 처리를 보강했습니다.
+
+## [4.2.1] - 2026-05-10
+
+### 수정됨 (Fixed)
+
 - **cli:** 티켓 탐색이 상위 워크스페이스를 상속하지 않고 현재 agent-rule 경계에서 멈추도록 수정했습니다.
+- **ticket:** `status`, `guard`, `move`의 Phase 1 검증을 동일하게 적용해, 미완성 상태 티켓이 숨김 없이 걸러지도록 수정했습니다.
+- **ticket:** `move` 단계에서 문자열 phase 값이 문자열 결합으로 오동작하는 것을 방지하기 위해 숫자 변환 후 산술 처리하도록 수정했습니다.
+
+## [4.0.38] - 2026-05-10
+
+### 수정됨 (Fixed)
+
+- **rules:** 승인 대기 상태의 최종 응답도 compact `Ticket start` 표면을 반복하도록 강제해, 최종 승인 대기 문구만 남아 활성 티켓 링크가 숨겨지는 문제를 막았습니다.
+
+## [4.0.37] - 2026-05-09
+
+### 수정됨 (Fixed)
+
+- **init:** init 성공 후 보이는 완료 피드백을 복구하고, 첫 사용 가이드로 ``이슈분석 티켓`이라고 해보세요.` 문구를 추가했습니다.
 
 ## [4.0.36] - 2026-05-09
 

package/CHANGELOG.md

@@ -10,7 +10,36 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ### Fixed
 
+- **ticket:** prefer heading-style APC markers in ticket templates without extra explanatory prose, so agents keep marker bodies on following lines.
+- **ticket:** validate APC create input from the whole APC section instead of slicing per marker, preserving compatibility with heading, bare, and inline marker styles.
+- **rules:** avoid emitting a second clickable link for the same ticket in the completion reply after `Ticket start` was already exposed.
+- **skills:** remove DeukAgentFlow-specific wording from shared skill summaries and ownership notes so consumer-facing templates stay generic.
+
+## [4.2.2] - 2026-05-10
+
+### Fixed
+
+- **release:** keep release-context carry-over so version bumping does not drop `Unreleased` items.
+
+## [4.2.1] - 2026-05-10
+
+### Fixed
+
 - **cli:** stop ticket discovery at the current agent-rule boundary instead of inheriting the parent workspace.
+- **ticket:** enforce Phase 1 planning completeness in `status`, `guard`, and `move` checks to prevent silent Phase-1 bypass.
+- **ticket:** coerce string phase values to numbers before phase transitions so moves can’t produce string-concatenation artifacts (for example, `"1" + 1 => "11"`).
+
+## [4.0.38] - 2026-05-10
+
+### Fixed
+
+- **rules:** require approval-pending final answers to repeat the compact `Ticket start` surface, preventing final-only approval text from hiding the active ticket link.
+
+## [4.0.37] - 2026-05-09
+
+### Fixed
+
+- **init:** restore a visible completion message after successful init and add the short first-use prompt guide ``이슈분석 티켓`이라고 해보세요.``
 
 ## [4.0.36] - 2026-05-09
 

package/NOTICE.md

@@ -0,0 +1,19 @@
+# Deuk Agent Flow Notice
+
+## v4.0.36 init hotfix
+
+Interactive `deuk-agent-flow init` now asks only for the workspace purpose. The CLI infers document language, workflow mode, ticket sharing, agent pointer defaults, and MCP memory defaults from the project directory or safe private defaults.
+
+The Deuk AgentContext MCP choice is hidden during first setup. MCP remains an optional companion setup that can be documented and configured separately.
+
+This hotfix also avoids the post-choice stall that could leave setup incomplete after the user answered an init prompt.
+
+Ticket creation/use surfaces must keep the clickable `Ticket start` line visible before asking for approval. Approval-only replies are treated as a hidden-ticket regression.
+
+## v4.0.37 init completion feedback
+
+Successful `init` now ends with a visible completion line and a short first-use prompt guide so terminal-first installs do not appear to finish silently.
+
+## v4.0.38 approval-pending final answer guard
+
+Approval-pending final answers must repeat the compact `Ticket start` surface. A final answer that only says approval is pending is treated as a hidden-ticket regression.

package/README.ko.md

@@ -2,7 +2,7 @@
   <br />
   <img src="docs/assets/architecture-v3.png" width="800" alt="DeukAgentFlow Architecture" />
   <br />
-  <h1>Deuk Agent Flow v4.0.36</h1>
+  <h1>Deuk Agent Flow v4.0.38</h1>
   <p>
     <a href="https://www.npmjs.com/package/deuk-agent-flow"><img src="https://img.shields.io/npm/v/deuk-agent-flow.svg?label=deuk-flow" alt="deuk-flow npm version" /></a>
     <a href="https://www.npmjs.com/package/deuk-agent-flow"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fjoygram%2FDeukAgentFlow%2Fmaster%2Fdocs%2Fbadges%2Fnpm-downloads.json" alt="deuk-flow combined npm downloads" /></a>
@@ -66,7 +66,7 @@ Deuk Agent Flow
 | 팀 기억 강화 | 완료된 작업이 검색 가능한 프로젝트 히스토리가 됨 |
 
 > **현재 배포 기준:**
-> v4.0.36은 에이전트 기반 리포지토리에 배포해 사용할 수 있는 상태입니다. 대화형 `init`은 이제 workspace 용도만 묻고, 나머지 설정은 프로젝트 디렉터리 성격으로 추론하며, Deuk AgentContext MCP 선택지는 첫 설정에서 숨김 처리하고, 이전의 다중 질문/먹통 완료 실패를 피합니다. 티켓 생성/사용 뒤에도 승인 요청 전에 클릭 가능한 `Ticket start` 줄이 계속 보이도록 했습니다. 현재는 **OpenAI Codex**와 **GitHub Copilot** 환경에서 가장 안정적으로 동작합니다. Cursor, Windsurf, Claude Code도 포인터 구조로 지원하지만, 워크스페이스별 검증을 권장합니다. Deuk AgentContext MCP는 선택형 기억 계층이며, MCP 서버 등록은 `init`에 딸려 들어가지 않고 별도로 설정합니다.
+> v4.0.38은 에이전트 기반 리포지토리에 배포해 사용할 수 있는 상태입니다. 대화형 `init`은 이제 workspace 용도만 묻고, 나머지 설정은 프로젝트 디렉터리 성격으로 추론하며, Deuk AgentContext MCP 선택지는 첫 설정에서 숨김 처리하고, 이전의 다중 질문/먹통 완료 실패를 피합니다. 이제 설치가 끝나면 완료 피드백과 짧은 첫 사용 가이드도 다시 보입니다. 티켓 생성/사용 뒤에도 승인 요청 전과 승인 대기 최종 응답에서 클릭 가능한 `Ticket start` 줄이 계속 보이도록 했습니다. 현재는 **OpenAI Codex**와 **GitHub Copilot** 환경에서 가장 안정적으로 동작합니다. Cursor, Windsurf, Claude Code도 포인터 구조로 지원하지만, 워크스페이스별 검증을 권장합니다. Deuk AgentContext MCP는 선택형 기억 계층이며, MCP 서버 등록은 `init`에 딸려 들어가지 않고 별도로 설정합니다.
 > **아키텍처 기반:**
 > 거대하고 무거운 레거시 `.cursorrules` 방식을 공식적으로 폐기했습니다. v3.0은 `AGENTS.md`를 단일 진실 공급원으로 사용하는 **Hub-Spoke 모델**을 도입하여, IDE별 규칙은 얇은 진입점 포인터 역할만 수행합니다.
 

package/README.md

@@ -2,7 +2,7 @@
   <br />
   <img src="docs/assets/architecture-v3.png" width="800" alt="DeukAgentFlow Architecture" />
   <br />
-  <h1>Deuk Agent Flow v4.0.36</h1>
+  <h1>Deuk Agent Flow v4.0.38</h1>
   <p>
     <a href="https://www.npmjs.com/package/deuk-agent-flow"><img src="https://img.shields.io/npm/v/deuk-agent-flow.svg?label=deuk-flow" alt="deuk-flow npm version" /></a>
     <a href="https://www.npmjs.com/package/deuk-agent-flow"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fjoygram%2FDeukAgentFlow%2Fmaster%2Fdocs%2Fbadges%2Fnpm-downloads.json" alt="deuk-flow combined npm downloads" /></a>
@@ -66,7 +66,7 @@ Repo-owned work
 | Better team memory | Completed work becomes searchable project history |
 
 > **Current readiness:**
-> v4.0.36 is deployment-ready for agent-driven repositories. Interactive `init` now asks only the workspace purpose, infers the remaining setup from the project directory, hides the Deuk AgentContext MCP choice during first setup, and completes without the earlier multi-prompt stall. Ticket creation/use also keeps the clickable `Ticket start` line visible before approval is requested. It is currently most reliable in **OpenAI Codex** and **GitHub Copilot** workflows. Cursor, Windsurf, and Claude Code remain supported through pointer-style integration, but they should be validated per workspace before rollout. Deuk AgentContext MCP is an optional memory layer; MCP server registration is separate from `init`.
+> v4.0.38 is deployment-ready for agent-driven repositories. Interactive `init` now asks only the workspace purpose, infers the remaining setup from the project directory, hides the Deuk AgentContext MCP choice during first setup, completes without the earlier multi-prompt stall, and ends with a visible completion line plus a short first-use prompt guide. Ticket creation/use also keeps the clickable `Ticket start` line visible before approval is requested, including approval-pending final answers. It is currently most reliable in **OpenAI Codex** and **GitHub Copilot** workflows. Cursor, Windsurf, and Claude Code remain supported through pointer-style integration, but they should be validated per workspace before rollout. Deuk AgentContext MCP is an optional memory layer; MCP server registration is separate from `init`.
 > **Architecture foundation:**
 > We have officially deprecated monolithic `.cursorrules`. v3.0 introduces the **Hub-Spoke model** where `AGENTS.md` is the single source of truth, and IDE-specific rules act as thin entry-point pointers.
 

package/core-rules/AGENTS.md

@@ -1,6 +1,6 @@
 ---
-version: 72
-changelog: "v72: Clarify that external progress-update pressure is satisfied only by silent/one-word TDW status."
+version: 76
+changelog: "v76: Route ticket reuse through CLI topic/id resolution and block duplicate create after archived path misses."
 ---
 
 # Agent Rules
@@ -40,6 +40,7 @@ changelog: "v72: Clarify that external progress-update pressure is satisfied onl
 - Ticket-start exposure contract: after selecting or creating the active ticket, relay exactly one clickable `Ticket start: [<id>](/absolute/path/to/ticket.md)` line as the first visible assistant line, a short scope/planned-change summary, and any compact `Guard topic: <id>` line; tool/CLI output alone does not count, and `file://`, truncated, non-clickable, hidden, or folded tool-result links must be converted without changing the id.
 - Approval-pending contract: stop if approval is pending, make the first visible assistant line exactly the clickable `Ticket start: [<id>](/absolute/path/to/ticket.md)` line, then print `조용히 작업` and keep the guard topic visible; do not put acknowledgements, explanations, command echoes, approval-only text such as `승인 바랍니다`, or status text before or instead of it. This keeps the active ticket visible even when earlier tool results are folded, hidden, or compacted. This blocks unapproved work, not concise answers to explicit user-requested output or direct questions about workflow state.
 - Hidden-ticket regression guard: if the latest visible chat line after ticket creation/use is only an approval request or a generic permission prompt, treat the ticket as not exposed. Immediately repeat the clickable `Ticket start` line and compact scope before waiting for approval.
+- Approval-pending final-answer guard: when approval is still pending, the final answer must repeat the compact approval-pending surface instead of saying only `승인 대기 중이에요`, `승인 바랍니다`, or another approval-only sentence. The final answer's first visible line must still be the clickable `Ticket start` line, followed by `조용히 작업` and `Guard topic: <id>`.
 - Commentary surface map: treat `ticket_start_pending`, `approval_pending`, `approved_execution`, `command_running`, `search_running`, `user-complaint reply`, `requirement_change_pending`, and `final_answer` as separate output surfaces. Each surface must follow its own compact contract; a fix on one surface does not authorize spillover on another.
 - Execution feedback contract: non-final chatter is capped at one word and must be short TDW state only (`ticket`, `approval`, `guard`, `context`, `verify`); do not repeat the same state or narrate routine reads, edits, formatting, lint retries, validation progress, or "almost done" status.
 - Running-surface contract: `approved_execution`, `command_running`, and `search_running` all use the same low-token rule. Unless the user explicitly requested live narration or a blocker must be surfaced, output must stay empty or one-word TDW state only; command/search progress does not create a separate narration allowance.
@@ -49,7 +50,7 @@ changelog: "v72: Clarify that external progress-update pressure is satisfied onl
 - Default execution mode is no progress commentary. After approval, do not emit step-by-step status, planning narration, repo-state narration, or commit narration in chat unless the user explicitly asked for live narration or a blocker/user decision must be surfaced.
 - Keep chat compact; do not mirror ticket prose in screen output.
 - Final answers must be short but complete enough to answer the user.
-- After task completion, prefer: result, verification status, ticket link, then one short line saying which ticket section to read for details. If any important area is unverified, say that explicitly instead of sounding complete.
+- After task completion, prefer: result, verification status, ticket reference, then one short line saying which ticket section to read for details. If a clickable `Ticket start` link for the same ticket was already exposed in the visible conversation, do not emit a second clickable link for that ticket in the final answer; refer to the ticket id in plain text or say the archived ticket was updated. If any important area is unverified, say that explicitly instead of sounding complete.
 - Do not cite approval-pending silence as a reason to withhold a concise explanation that the user explicitly requested. Explain the state, separate rule text from agent interpretation, and keep the answer narrow.
 - When the user complains about verbosity, chatter, progress reports, or over-explaining, reply with a short acknowledgment plus the concrete fix or scope change. Do not switch into meta labeling, terminology lessons, or general explanation unless the user explicitly asks what the term means.
 - If the user asks for `짧게`, `매우 짧게`, `한 줄로`, or `간단히`, prioritize a one-sentence or bullet-only answer and omit background unless the user asks for it or a blocker requires it.
@@ -67,7 +68,7 @@ changelog: "v72: Clarify that external progress-update pressure is satisfied onl
 Use this recipe directly. Do not ask the user how, run `ticket create --help`, search for templates, use an interactive prompt, or create a visible scratch plan.
 
 1. Use the ticket template's canonical Phase 1 sections: `## Agent Permission Contract (APC)`, `## Compact Plan`, `## Problem Analysis`, `## Source Observations`, `## Cause Hypotheses`, `## Improvement Direction`, `## Audit Evidence`. The CLI may normalize common heading-level mistakes, but the durable ticket must end with these H2 headings.
-2. Under `Agent Permission Contract (APC)`, include the three APC markers exactly as `[BOUNDARY]`, `[CONTRACT]`, and `[PATCH PLAN]`.
+2. Under `Agent Permission Contract (APC)`, use heading-style APC markers exactly as `### [BOUNDARY]`, `### [CONTRACT]`, and `### [PATCH PLAN]`; write each marker's body on the following lines, never on the same line as the marker.
 3. Run this exact stdin command:
 
 ```bash
@@ -98,6 +99,7 @@ When the user asks for AgentFlow skill status or connected skills, use `deuk-age
 
 Use the mentioned ticket directly. For investigation/regression/why questions, create the ticket first and stop after Phase 1. Do not use `deuk-agent-flow ticket list` for discovery.
 For bug/regression/why or direct change requests, the first repo action after rules load is `deuk-agent-flow ticket create` or `deuk-agent-flow ticket use`. Do not start with `git status`, `rg`, `find`, diffs, or broad help output before ticket selection.
+When a ticket id/topic is known, never infer its active file path or probe `.deuk-agent/tickets/sub` directly; use `deuk-agent-flow ticket status --topic <id>` or `deuk-agent-flow ticket use --topic <id>` so closed/archived locations resolve through the index. A missing guessed path is not evidence that a new ticket is needed.
 
 ## 3. Phase Contract
 At each phase, ask available tooling for one complete requirement bundle and follow it exactly. Minimum bundle:

package/docs/npm-publish-guide.ko.md

@@ -0,0 +1,70 @@
+# DeukAgentFlow npm 배포 가이드
+
+`deuk-agent-flow`가 본패키지이고 `deuk-agent-rule`은 호환용 alias 패키지다.
+
+## 배포 전 확인
+
+1. `package.json`의 `repository`, `bugs`, `homepage`가 현재 Git 저장소 URL을 가리키는지 확인한다.
+2. `packages/deuk-agent-rule/package.json`의 version과 `deuk-agent-flow` dependency가 root version과 같은지 확인한다.
+3. 다운로드 배지는 `deuk-agent-flow`를 canonical package로 두고 `deuk-agent-rule`을 alias contribution으로 합산한다.
+
+## 검증 순서
+
+```bash
+npm test
+npm run smoke:npm:local
+npm run publish:dry
+```
+
+Docker가 가능한 환경에서는 추가로 실행한다.
+
+```bash
+npm run smoke:npm:docker
+```
+
+Windows에서는 다음 명령으로 `.cmd` shim 생성까지 확인한다.
+
+```bat
+node scripts\smoke-npm-local.mjs
+where deuk-agent-flow
+where deuk-agent-rule
+```
+
+## 실제 배포
+
+root에서 실행한다.
+
+```bash
+npm run publish
+```
+
+이 명령은 다음 순서로 동작한다.
+
+1. `deuk-agent-rule` alias package metadata를 root package 기준으로 동기화한다.
+2. `npm test`를 실행한다.
+3. local npm install smoke를 실행한다.
+4. `deuk-agent-flow`를 먼저 publish한다.
+5. `deuk-agent-rule` alias package를 publish한다.
+
+이미 같은 버전의 `deuk-agent-flow`가 올라갔고 alias만 다시 올려야 하면 다음 명령을 사용한다.
+
+```bash
+npm run publish:bootstrap
+```
+
+## 배포 후 확인
+
+```bash
+npm view deuk-agent-flow version
+npm view deuk-agent-rule version
+npm install -g deuk-agent-flow
+deuk-agent-flow --help
+npm install -g deuk-agent-rule
+deuk-agent-rule --help
+```
+
+다운로드 배지는 필요하면 갱신한다.
+
+```bash
+npm run badge:downloads
+```

package/docs/usage-guide.ko.md

@@ -164,7 +164,7 @@ git diff -- .deuk-agent/tickets/INDEX.archive.*.json
 
 스킬은 전체 workflow를 대체하지 않는 짧은 행동 playbook입니다. DeukAgentFlow에서는 티켓/APC/Phase Gate가 계속 상위 권한이고, 스킬은 특정 실패 패턴에서 에이전트의 움직임만 더 날카롭게 만듭니다.
 
-`init`을 실행하면 first-party 스킬 원본은 `.deuk-agent/skill-templates/`로 동기화됩니다. 실제 장착은 프로젝트 성격에 맞게 `skill add`로 선택합니다.
+`init`은 first-party 스킬 원본을 프로젝트 안으로 복제하지 않습니다. 스킬 원본은 DeukAgentFlow 패키지의 `templates/skills/`가 SSoT입니다.
 
 기본 추천 장착:
 
@@ -201,7 +201,7 @@ deuk-agent-flow skill expose --platform claude
 deuk-agent-flow skill expose --platform cursor
 ```
 
-`skill add`는 프로젝트의 `.deuk-agent/skills/<id>/SKILL.md`에 스킬을 설치하고, `skill expose`는 설치된 스킬을 Claude/Cursor가 읽을 수 있는 얇은 포인터로 노출합니다.
+`skill add`/`skill expose`는 스킬 사용 경로를 열지만, `init`은 로컬 스킬 템플릿 복제본을 만들거나 보존하지 않습니다.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deuk-agent-flow",
-  "version": "4.0.36",
+  "version": "4.2.7",
   "description": "Keep AI coding work from vanishing between chats: repo-owned tickets, scope, verification, and memory for AGENTS.md-powered agents.",
   "keywords": [
     "agents-md",
@@ -22,19 +22,17 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/joygram/DeukAgentFlow.git"
+    "url": "https://github.com/joygram/DeukAgentFlow.git"
   },
   "bugs": {
     "url": "https://github.com/joygram/DeukAgentFlow/issues"
   },
   "homepage": "https://github.com/joygram/DeukAgentFlow#readme",
   "files": [
-    "LICENSE",
     "bin/**/*",
     "core-rules/**/*",
     "docs/architecture.md",
     "docs/architecture.ko.md",
-    "docs/badges/**/*",
     "docs/how-it-works.md",
     "docs/how-it-works.ko.md",
     "docs/principles.md",
@@ -42,6 +40,7 @@
     "docs/npm-publish-guide.ko.md",
     "docs/usage-guide.ko.md",
     "docs/assets/**/*",
+    "NOTICE.md",
     "templates/**/*",
     "scripts/cli.mjs",
     "scripts/cli-args.mjs",
@@ -52,6 +51,7 @@
     "scripts/cli-rule-compiler.mjs",
     "scripts/cli-skill-commands.mjs",
     "scripts/cli-telemetry-commands.mjs",
+    "scripts/cli-ticket-command-shared.mjs",
     "scripts/cli-ticket-commands.mjs",
     "scripts/cli-ticket-index.mjs",
     "scripts/cli-ticket-migration.mjs",
@@ -71,13 +71,20 @@
     "CHANGELOG.ko.md"
   ],
   "scripts": {
+    "bump": "commit-and-tag-version",
+    "bump:patch": "commit-and-tag-version -r patch",
+    "bump:minor": "commit-and-tag-version -r minor",
+    "bump:major": "commit-and-tag-version -r major",
+    "merge:dry": "node scripts/cli.mjs merge --dry-run --cwd .. --agents skip",
     "lint:md": "node scripts/lint-md.mjs",
-    "publish": "node scripts/publish-dual-npm.mjs --skip-tests",
-    "publish:dry": "node scripts/publish-dual-npm.mjs --dry-run --skip-tests",
+    "test": "node --test scripts/tests/*.test.mjs",
+    "sync:oss": "node scripts/sync-oss.mjs",
+    "publish": "node scripts/publish-dual-npm.mjs",
+    "publish:dry": "node scripts/publish-dual-npm.mjs --dry-run",
     "smoke:npm:local": "node scripts/smoke-npm-local.mjs",
     "smoke:npm:docker": "node scripts/smoke-npm-docker.mjs",
-    "publish:bootstrap": "node scripts/publish-dual-npm.mjs --alias-only --skip-tests",
-    "publish:bootstrap:dry": "node scripts/publish-dual-npm.mjs --alias-only --dry-run --skip-tests",
+    "publish:bootstrap": "node scripts/publish-dual-npm.mjs --alias-only",
+    "publish:bootstrap:dry": "node scripts/publish-dual-npm.mjs --alias-only --dry-run",
     "badge:downloads": "node scripts/update-download-badge.mjs"
   },
   "engines": {
@@ -89,6 +96,9 @@
     "deuk-agent-rule": "./bin/deuk-agent-rule.js",
     "deukagentrule": "./bin/deuk-agent-rule.js"
   },
+  "devDependencies": {
+    "commit-and-tag-version": "^12.7.1"
+  },
   "dependencies": {
     "ejs": "^5.0.2",
     "yaml": "^2.8.3"

package/scripts/cli-init-commands.mjs

@@ -1,6 +1,6 @@
 import { join, dirname, basename, relative } from "path";
 import { homedir } from "os";
-import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, readdirSync, unlinkSync, rmSync, renameSync, statSync, cpSync, symlinkSync, chmodSync } from "fs";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, readdirSync, unlinkSync, rmSync, renameSync, statSync, symlinkSync, chmodSync } from "fs";
 
 import { ensureTicketDirAndGitignore } from "./cli-init-logic.mjs";
 import { normalizeTicketPaths } from "./cli-ticket-migration.mjs";
@@ -44,6 +44,29 @@ const SOURCE_MODE_COMMANDS = [
   ["deuk-agent-rule", "deuk-agent-rule.js"],
   ["deukagentrule", "deuk-agent-rule.js"]
 ];
+const CANONICAL_INIT_CLEANUP_PATHS = {
+  runtimeTemplateCopies: [join(AGENT_ROOT_DIR, "templates"), LEGACY_TEMPLATE_DIR],
+  localSkillCopies: [
+    join(AGENT_ROOT_DIR, "skill-templates"),
+    join(AGENT_ROOT_DIR, "skills"),
+    join(AGENT_ROOT_DIR, "skills.json"),
+    join(".claude", "skills"),
+    join(".cursor", "rules", "deuk-agent-skills.mdc")
+  ],
+  duplicateRuleCopies: [join(AGENT_ROOT_DIR, "rules"), join(".cursor", "rules", "deuk-agent-rule-multi-ai-workflow.mdc")],
+};
+
+function removeLegacyPaths(cwd, dryRun, paths, label) {
+  let removed = 0;
+  for (const relPath of paths) {
+    const target = join(cwd, relPath);
+    if (!existsSync(target)) continue;
+    if (!dryRun) rmSync(target, { recursive: true, force: true });
+    console.log(`[CLEANUP] removed ${label}: ${toRepoRelativePath(cwd, target)}`);
+    removed += 1;
+  }
+  return removed;
+}
 
 function pathEntries(pathEnv = process.env.PATH || "", platform = process.platform) {
   return String(pathEnv || "").split(platform === "win32" ? ";" : ":").filter(Boolean);
@@ -813,8 +836,10 @@ function canonicalizeAgentRootLayout(cwd, dryRun) {
     console.log(`[CLEANUP] removed runtime template copy: ${toRepoRelativePath(cwd, runtimeTemplates)}`);
   }
 
-  const allowedDirs = new Set(["docs", "knowledge", "tickets", "skill-templates", "skills"]);
-  const allowedFiles = new Set(["config.json", "telemetry.jsonl", "skills.json", "usage.json"]);
+  removeLocalSkillCopies(cwd, dryRun);
+
+  const allowedDirs = new Set(["docs", "knowledge", "tickets"]);
+  const allowedFiles = new Set(["config.json", "telemetry.jsonl", "usage.json"]);
 
   for (const entry of sortedDirEntries(agentRoot, { withFileTypes: true })) {
     const sourceAbs = join(agentRoot, entry.name);
@@ -1334,27 +1359,11 @@ function canonicalizeRecursiveInitSurfaces(cwd, bundleRoot, dryRun) {
 }
 
 function removeRuntimeTemplateCopies(cwd, dryRun) {
-  const runtimeTemplates = join(cwd, AGENT_ROOT_DIR, "templates");
-  const legacyTemplates = join(cwd, LEGACY_TEMPLATE_DIR);
-  for (const target of [runtimeTemplates, legacyTemplates]) {
-    if (!existsSync(target)) continue;
-    if (!dryRun) rmSync(target, { recursive: true, force: true });
-    console.log(`[CLEANUP] removed runtime template copy: ${toRepoRelativePath(cwd, target)}`);
-  }
+  removeLegacyPaths(cwd, dryRun, CANONICAL_INIT_CLEANUP_PATHS.runtimeTemplateCopies, "runtime template copy");
 }
 
-function syncSkillTemplates(cwd, bundleRoot, dryRun) {
-  const skillDestDir = join(cwd, AGENT_ROOT_DIR, "skill-templates");
-  const skillSourceDir = join(bundleRoot, "templates", "skills");
-  if (!existsSync(skillSourceDir)) return;
-
-  if (!dryRun) {
-    mkdirSync(skillDestDir, { recursive: true });
-    cpSync(skillSourceDir, skillDestDir, { recursive: true });
-    console.log(`[SYNC] skill templates synced to ${toRepoRelativePath(cwd, skillDestDir)}`);
-    return;
-  }
-  console.log(`[SYNC] skill templates synced to ${toRepoRelativePath(cwd, skillDestDir)} (dry-run mode)`);
+function removeLocalSkillCopies(cwd, dryRun) {
+  removeLegacyPaths(cwd, dryRun, CANONICAL_INIT_CLEANUP_PATHS.localSkillCopies, "local skill copy");
 }
 
 function canonicalizeLegacyDeukAgentText(content, bundleRoot) {
@@ -1520,6 +1529,18 @@ function migrateMissingFrontmatter(cwd, dryRun) {
   }
 }
 
+function runInitArchiveNormalizationPasses(cwd, dryRun) {
+  const passes = [
+    () => canonicalizeTicketArchivePath(cwd, dryRun),
+    () => canonicalizeDocsArchiveBuckets(cwd, dryRun),
+    () => enforceCanonicalAgentLayout(cwd, dryRun),
+    () => mergeSeparatedDocsIntoTickets(cwd, dryRun),
+    () => canonicalizeTicketArchivePath(cwd, dryRun),
+    () => enforceCanonicalAgentLayout(cwd, dryRun),
+  ];
+  for (const pass of passes) pass();
+}
+
 export function buildGlobalCodexInstructions() {
   return `---
 
@@ -1563,7 +1584,7 @@ This pointer is a thin bootstrap, not a second workflow contract.
 2. Then read local \`PROJECT_RULE.md\` and internally identify applicable DC-* rules.
 3. After the core hub is loaded, \`core-rules/AGENTS.md\` is the DeukAgentFlow SSoT for TDW, RAG, silence, scope, and verification.
 
-Do not print pointer/core metadata, version, DC-* lists, progress commentary, or interim summaries. When approval is pending, make the first visible assistant line exactly the clickable \`Ticket start: [<id>](/absolute/path/to/ticket.md)\` line; never leave only an approval request such as \`승인 바랍니다\` visible after ticket creation/use. Before the final answer, only the single required ticket-start line, blockers, explicit user-requested output, or explicit command results may appear. During approved_execution, command_running, or search_running, stay silent unless the user explicitly asks for live narration or a blocker/user decision must be surfaced.
+Do not print pointer/core metadata, version, DC-* lists, progress commentary, or interim summaries. When approval is pending, make the first visible assistant line exactly the clickable \`Ticket start: [<id>](/absolute/path/to/ticket.md)\` line, including in the final answer if approval is still pending; never leave only an approval request such as \`승인 바랍니다\` or \`승인 대기 중이에요\` visible after ticket creation/use. Before the final answer, only the single required ticket-start line, blockers, explicit user-requested output, or explicit command results may appear. During approved_execution, command_running, or search_running, stay silent unless the user explicitly asks for live narration or a blocker/user decision must be surfaced.
 `;
 
   if (spoke.format === "mdc") {
@@ -1621,16 +1642,7 @@ function removeDuplicateRuleCopies(cwd, dryRun) {
   // Note: AGENTS.md is now the Antigravity spoke target — do NOT delete it here.
   // CLAUDE.md/GEMINI.md legacy cleanup is handled by deploySpokePointers (spoke.legacy field).
   // .gemini is the Antigravity platform directory — preserve it.
-  const duplicatePaths = [
-    join(cwd, AGENT_ROOT_DIR, "rules"),
-    join(cwd, ".cursor", "rules", "deuk-agent-rule-multi-ai-workflow.mdc"),
-  ];
-
-  for (const p of duplicatePaths) {
-    if (!existsSync(p)) continue;
-    if (!dryRun) rmSync(p, { recursive: true, force: true });
-    console.log(`[CLEANUP] removed legacy/duplicate: ${toRepoRelativePath(cwd, p)}`);
-  }
+  removeLegacyPaths(cwd, dryRun, CANONICAL_INIT_CLEANUP_PATHS.duplicateRuleCopies, "legacy/duplicate");
 }
 
 export async function runInit(opts, bundleRoot) {
@@ -1684,6 +1696,11 @@ export async function runInit(opts, bundleRoot) {
   }
 }
 
+export function formatInitCompletionMessage(cwd, dryRun = false) {
+  const label = dryRun ? "Dry-run complete" : "Init complete";
+  return `[DONE] ${label} for ${basename(cwd)}. Rules and pointers are ready. \`이슈분석 티켓\`이라고 해보세요.`;
+}
+
 async function initSingleWorkspace(subCwd, opts, bundleRoot, selectedTools) {
   console.log(`\nInitializing ${basename(subCwd)}...`);
   
@@ -1700,10 +1717,7 @@ async function initSingleWorkspace(subCwd, opts, bundleRoot, selectedTools) {
   migrateMissingFrontmatter(subCwd, opts.dryRun);
 
   // 2.6. Deterministic archive/docs normalization
-  canonicalizeTicketArchivePath(subCwd, opts.dryRun);
-  canonicalizeDocsArchiveBuckets(subCwd, opts.dryRun);
-  enforceCanonicalAgentLayout(subCwd, opts.dryRun);
-  mergeSeparatedDocsIntoTickets(subCwd, opts.dryRun);
+  runInitArchiveNormalizationPasses(subCwd, opts.dryRun);
   if (!opts.dryRun) {
     const rebuiltIndex = rebuildTicketIndexFromTopicFilesIfNeeded(subCwd, { force: true });
     writeTicketIndexJson(subCwd, rebuiltIndex, { force: true });
@@ -1725,7 +1739,7 @@ async function initSingleWorkspace(subCwd, opts, bundleRoot, selectedTools) {
 
   // 5. Runtime template cleanup; package templates/ is the SSoT.
   removeRuntimeTemplateCopies(subCwd, opts.dryRun);
-  syncSkillTemplates(subCwd, bundleRoot, opts.dryRun);
+  removeLocalSkillCopies(subCwd, opts.dryRun);
   canonicalizeGeneratedCommandReferences(subCwd, bundleRoot, opts.dryRun);
   canonicalizeRecursiveInitSurfaces(subCwd, bundleRoot, opts.dryRun);
 }
@@ -1741,5 +1755,5 @@ export function runMerge(opts, bundleRoot) {
   }
   
   removeRuntimeTemplateCopies(opts.cwd, opts.dryRun);
-  syncSkillTemplates(opts.cwd, bundleRoot, opts.dryRun);
+  removeLocalSkillCopies(opts.cwd, opts.dryRun);
 }

package/scripts/cli-skill-commands.mjs

@@ -6,17 +6,29 @@ import { AGENT_ROOT_DIR } from "./cli-utils.mjs";
 const SKILL_IDS = ["safe-refactor", "generated-file-guard", "context-recall", "project-pilot"];
 const SKILL_ROOT = "templates/skills";
 const CONFIG_FILE = `${AGENT_ROOT_DIR}/skills.json`;
-const REPO_SKILL_TEMPLATE_ROOT = `${AGENT_ROOT_DIR}/skill-templates`;
 const PACKAGE_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
+const SKILL_PATHS = {
+  installedRoot: join(AGENT_ROOT_DIR, "skills"),
+  templateRoot: SKILL_ROOT,
+  claudeRoot: join(".claude", "skills"),
+  cursorPointer: join(".cursor", "rules", "deuk-agent-skills.mdc"),
+};
+
+function safeReadJson(absPath, fallback = null) {
+  if (!existsSync(absPath)) return fallback;
+  try {
+    return JSON.parse(readFileSync(absPath, "utf8"));
+  } catch {
+    return fallback;
+  }
+}
 
 function repoSkillPath(cwd, id) {
-  return join(cwd, AGENT_ROOT_DIR, "skills", id, "SKILL.md");
+  return join(cwd, SKILL_PATHS.installedRoot, id, "SKILL.md");
 }
 
 function sourceSkillPath(cwd, id) {
-  const localTemplate = join(cwd, REPO_SKILL_TEMPLATE_ROOT, id, "SKILL.md");
-  if (existsSync(localTemplate)) return localTemplate;
-  const repoTemplate = join(cwd, SKILL_ROOT, id, "SKILL.md");
+  const repoTemplate = join(cwd, SKILL_PATHS.templateRoot, id, "SKILL.md");
   if (existsSync(repoTemplate)) return repoTemplate;
   return join(PACKAGE_ROOT, SKILL_ROOT, id, "SKILL.md");
 }
@@ -29,18 +41,17 @@ function loadSkillSource(cwd, id) {
 
 function loadSkillConfig(cwd) {
   const path = join(cwd, CONFIG_FILE);
-  if (!existsSync(path)) return { version: 1, installed: [], exposed: {} };
-  return JSON.parse(readFileSync(path, "utf8"));
+  return safeReadJson(path, { version: 1, installed: [], exposed: {} });
 }
 
 function detectExposedPlatforms(cwd, id) {
   const platforms = [];
-  const claudePath = join(cwd, ".claude", "skills", id, "SKILL.md");
+  const claudePath = join(cwd, SKILL_PATHS.claudeRoot, id, "SKILL.md");
   if (existsSync(claudePath)) {
     platforms.push("claude");
   }
 
-  const cursorPath = join(cwd, ".cursor", "rules", "deuk-agent-skills.mdc");
+  const cursorPath = join(cwd, SKILL_PATHS.cursorPointer);
   if (existsSync(cursorPath)) {
     try {
       const body = readFileSync(cursorPath, "utf8");
@@ -101,7 +112,7 @@ export function addSkill(opts = {}) {
 function exposeClaude(cwd, ids, dryRun) {
   for (const id of ids) {
     const body = readFileSync(repoSkillPath(cwd, id), "utf8");
-    const target = join(cwd, ".claude", "skills", id, "SKILL.md");
+    const target = join(cwd, SKILL_PATHS.claudeRoot, id, "SKILL.md");
     if (!dryRun) {
       mkdirSync(dirname(target), { recursive: true });
       writeFileSync(target, body, "utf8");
@@ -110,7 +121,7 @@ function exposeClaude(cwd, ids, dryRun) {
 }
 
 function exposeCursor(cwd, ids, dryRun) {
-  const target = join(cwd, ".cursor", "rules", "deuk-agent-skills.mdc");
+  const target = join(cwd, SKILL_PATHS.cursorPointer);
   const body = [
     "---",
     "description: \"DeukAgentFlow skill pointers\"",
@@ -153,7 +164,7 @@ export function exposeSkills(opts = {}) {
 
 export function lintSkills(cwd = process.cwd()) {
   const paths = [];
-  for (const root of [join(cwd, SKILL_ROOT), join(cwd, REPO_SKILL_TEMPLATE_ROOT), join(cwd, AGENT_ROOT_DIR, "skills")]) {
+  for (const root of [join(cwd, SKILL_ROOT), join(cwd, SKILL_PATHS.installedRoot)]) {
     if (!existsSync(root)) continue;
     for (const id of readdirSync(root)) {
       const path = join(root, id, "SKILL.md");