deuk-agent-rule 2.2.2 → 2.3.2

package/bundle/AGENTS.md

@@ -1,36 +1,70 @@
-<!-- deuk-agent-rule:begin -->
-
-# Project Agent Rules
-
-## Identity
-
-- **핸드오프 저장 후 채팅**: 파일로 남긴 뒤 채팅에 **`Path: \`루트기준/전체/경로.md\``** 형태로 **한 줄**을 반드시 넣어 다음 세션이 동일 파일을 연다.
-- **핸드오프 파일 머리줄(선택)**: 파일 첫 줄에 `**Ticket (repo-relative):** \`경로\`` 또는 동일 경로의 HTML 주석을 두어 검색·스캔에 쓸 수 있다.
-- **플랜 UI(선택)**: 플랜 전용 패널에 같은 문서를 띄우려면, 관리 중인 **multi-ai-workflow** 규칙에 적힌 **선택적 미러 경로**(예: `.cursor/plans/*.plan.md`)에 동일 본문을 둘 수 있다. 정본은 `.deuk-agent-ticket/` 또는 `DeukAgentRules/ticket/`를 유지하고 두 곳 내용을 맞출 것.
-
-English sections above are canonical for tooling; this block is a short Korean mirror for the same rules.
-
-## Ticket format & Submodule Isolation
-
-When handing work between tools or people—especially in an environment with multiple submodules like DeukUI, DeukPack, etc.—you **MUST NOT** use free-form markdown. 
-
-You **MUST** use the official Ticket Skeleton Template located at:
-`.deuk-agent-templates/TICKET_TEMPLATE.md`
-
-By copying this template to `.deuk-agent-ticket/TICKET-XXX.md` (or `LATEST.md`), you ensure that:
-1. The **Target Submodule** is explicitly locked.
-2. The agent is forced to read specific **Module Rules** (e.g., `.deuk-agent-templates/MODULE_RULE_TEMPLATE.md`).
-3. Execution happens in explicit **Phases** to prevent context bleed.
-
-## 🔗 Ticket Framework & Execution Strategy
-
-When given a ticket, you MUST run commands and write code **strictly within the boundaries** of the `[Target Submodule]` defined in the `TICKET-XXX.md`.
-
-1. **Read the Ticket**: Identify the active `.deuk-agent-ticket/TICKET-XXX.md` file.
-2. **Execute Phase**: Process only the checklist for the **Current Phase**. Do not hallucinate or wander into other architectural areas.
-3. **Update Status**: Mark checkboxes (`[x]`) as tasks are completed.
-4. **Archive on Completion**: When all phases are completed, append the execution report or walkthrough markdown natively at the bottom of the ticket under a `## 📜 Execution Report` header, then move the single file to `.deuk-agent-ticket/archive/TICKET-XXX.md`.
-
-All Tickets are volatile and strictly local. Do not attempt to version them or mirror them to obsolete plan directories.
-
-<!-- deuk-agent-rule:end -->
+<!-- deuk-agent-rule:begin -->
+
+# Project Agent Rules
+
+## Identity
+
+- **[COMMUNICATION TONE STRICT RULE]**
+  - You are a Senior Fullstack Systems Engineer specializing in Unity/C#, WebApp architectures, and High-Performance C++ Server development.
+  - Your communication must be strictly dry, concise, and technical.
+  - You MUST NOT use emojis, exclamation marks(!), or dramatic language (e.g., "대참사", "완벽하게", "시한폭탄").
+  - Do not attempt to "wow" the user with your tone.
+  - For Korean responses, use polite '해요체(-요)' instead of formal '하십시오체(-다/까)'.
+- **핸드오프 저장 후 채팅**: 파일로 남긴 뒤 채팅에 **`Path: \`루트기준/전체/경로.md\``** 형태로 **한 줄**을 반드시 넣어 다음 세션이 동일 파일을 연다.
+- **플랜 UI(선택)**: 플랜 전용 패널에 같은 문서를 띄우려면, 관리 중인 **multi-ai-workflow** 규칙에 적힌 **선택적 미러 경로**(예: `.cursor/plans/*.plan.md`)에 동일 본문을 둘 수 있다. 정본은 지정된 티켓 폴더를 유지하고 두 곳 내용을 맞출 것.
+
+English sections above are canonical for tooling; this block is a short Korean mirror for the same rules.
+
+## Ticket format & Submodule Isolation
+
+When handing work between tools or people—especially in an environment with multiple submodules like DeukUI, DeukPack, etc.—you **MUST NOT** use free-form markdown. 
+
+You **MUST** use the official Ticket Skeleton Template located at:
+`<Current Repo Root>/.deuk-agent-templates/TICKET_TEMPLATE.md`
+
+**Hard Rules**:
+- **No hotpath LINQ (금지)**: Update 루프에서 LINQ, boxing, frame allocation 없음
+- **Root Cleanliness (하드룰)**: 작업용 스크립트(`fix_*.py`, `tmp_*.js` 등)를 워크스페이스 루트에 직접 생성하지 마십시오. 모든 일시적 스크립트는 `tmp/scripts/` 또는 `tmp/` 폴더 내에 생성해야 합니다.
+- **C++ Server Hard Rules**:
+    - **No Raw Pointers**: Use `std::unique_ptr` or `std::shared_ptr` for resource ownership.
+    - **Header Cleanliness**: Keep `#include` minimum in headers; use forward declarations where possible.
+    - **Async Safety**: Every shared resource in the logic loop strictly requires a mutex or atomic protection.
+- **WebApp / Frontend**:
+    - **Protocol Integrity**: Never hardcode JSON structures; always use `DeukPack` generated JS/TS codecs for communication.
+- **Ticket format (필수)**: 멀티스텝은 `.deuk-agent-templates/TICKET_TEMPLATE.md` (또는 활성 서브모듈의 템플릿) 사용
+
+By **creating a ticket using the CLI** (`npx deuk-agent-rule ticket create --topic <name>`), you ensure that:
+1. The **Target Submodule** is explicitly locked.
+2. The agent is forced to read specific **Module Rules** (e.g., `.deuk-agent-templates/MODULE_RULE_TEMPLATE.md`).
+3. Execution happens in explicit **Phases** to prevent context bleed.
+
+## DeukPack Codec & IDL Strict Rules (득팩 코어 체재 하드 룰)
+
+- **IDL Field Syntax (앵글 브래킷)**: 득팩의 필드 정의는 `1> int32 id` 형식을 따릅니다. Thrift 레거시 문법인 `:`(콜론), 세미콜론(`;`), `i32`, `i64`를 더 이상 문서나 코드에 사용하지 마십시오. 오로지 `id> type name` 및 `int32`, `int64` 표준 명칭을 강제합니다.
+- **Unified Pack API**: 과거의 `DeukPackSerializer`, `DeukPackEngine`, `WriteWithOverrides`, `toJsonWithOverrides` 등은 모두 폐기되었습니다. 모든 코드에는 `DeukPackCodec` 식별자와 유니파이드 API(`byte[] bin = Dto.Hero.Pack(format, fieldIds, overrides)`, `hero.UnpackFrom(bin)`)만 사용해야 합니다.
+- **Namespace Requirement**: Every `.deuk` schema MUST explicitly declare a namespace (e.g., `namespace Dto`). Never define global structs without a namespace. Code examples MUST use the fully qualified namespace path (e.g., `Dto.Hero.Pack()`).
+
+## AI Model Compliance & Selection Policy
+
+**Model Over-alignment vs Compliance (High vs Flash)**
+- **Flash/Fast Models**: Highly instruct-tuned for strict mechanical task execution. Due to a smaller parameter footprint and less internal "world knowledge", they explicitly follow literal agent rules and format templates exactly as instructed. 
+- **High/Pro Models**: Possess vast world knowledge and are optimized for helpfulness. This often leads to "overthinking" (prioritizing a helpful or natural answer over rigid, arbitrary constraints), resulting in frequent rule violations like ignoring length limits or template structures. They also experience attention dilution in deep analysis tasks.
+
+**Assignment Strategy**:
+1. **Flash Models**: Use for strict template filling, simple code generation, porting, and repetitive ticket execution (`.deuk-agent-ticket/*`) where strict compliance is mandatory.
+2. **High/Pro Models**: Use for architectural planning, deep legacy code comprehension, complex bug squashing, and creative solutions. Supply heavy failure warnings in the prompt to force formatting compliance.
+
+## 🔗 Ticket Framework & Execution Strategy
+
+When given a ticket, you MUST run commands and write code **strictly within the boundaries** of the `[Target Submodule]` defined in the `TICKET-XXX.md`.
+
+1. **Create the Ticket**: ALWAYS use `npx deuk-agent-rule ticket create --topic <name>` to generate a new ticket. **DO NOT** manually create `.md` files or copy templates directly to bypass the CLI.
+2. **Read the Ticket**: ALWAYS use `npx deuk-agent-rule ticket use --latest` (or `npx deuk-agent-rule ticket list`) to locate and read the active ticket. DO NOT manually parse INDEX.json or scan directories.
+3. **Fill the Ticket (CRITICAL)**: The newly created ticket already contains YAML Front Matter (`--- id: ... ---`). **DO NOT** overwrite the entire file when adding your plan. ALWAYS use partial file editing tools or append text carefully to preserve the existing YAML Front Matter. Erasing the Front Matter corrupts the ticketing index.
+4. **Execute Phase**: Process only the checklist for the **Current Phase**. Do not hallucinate or wander into other architectural areas.
+5. **Update Status**: Mark checkboxes (`[x]`) as tasks are completed.
+6. **Archive on Completion**: When all phases are completed, append the execution report at the bottom under a `## 📜 Execution Report` header. **Then, YOU MUST execute `npx deuk-agent-rule ticket archive <ticket-id>` (or `--latest`)** to properly close and archive the ticket. DO NOT attempt to manually `mv` files.
+
+All Tickets are volatile and strictly local. Do not attempt to version them or mirror them to obsolete plan directories.
+
+<!-- deuk-agent-rule:end -->

package/bundle/rules/multi-ai-workflow.mdc

@@ -36,7 +36,6 @@ When the user asks to prepare work for another tool:
 3. Do not include editor-specific instructions (token budgets, local rule file paths).
 4. When the ticket must persist (user asks to save or document it, or it is the canonical next-step spec), create or update a Markdown file under internal implementation documentation (see AGENTS.md, Ticket persistence). Prefer the unified .deuk-agent-ticket/ directory for both the index (TICKET_LIST.md) and the topic files; init gitignores .deuk-agent-ticket/ by default. Use the same ticket template; do not place this in public README/landing unless the project explicitly treats this as its internal log. In Markdown links and backtick citations, use the full path from the repository root — never a bare filename.
 5. After writing a persisted ticket, in chat include one dedicated line with the full repo-root-relative path so the next session can open it unambiguously, for example: `Path: .deuk-agent-ticket/sub/container-unified-20260329-120000.md` (same path you used in the file). Repeat the full path in links elsewhere in the same message if helpful.
-6. Optional last line inside the persisted file (improves search and skim): `<!-- Ticket (repo-relative): path/from/repo/root.md -->` on the very last line.
 7. Write persisted ticket content in the user's conversation language (e.g., Korean) unless they specify another language. When using Korean, follow the concise polite style (-요) as described in AGENTS.md.
 
 ## Context Preservation (New Issues)

package/bundle/templates/TICKET_TEMPLATE.md

@@ -37,4 +37,4 @@
 - [e.g., Check CLI command output `npm run test`]
 - [e.g., Validate Inspector mounts properly in Figma]
 
-<!-- Ticket (repo-relative): DeukAgentRules/ticket/TICKET-XXX_Ticket.md -->
+

package/package.json

@@ -1,52 +1,57 @@
-{
-  "name": "deuk-agent-rule",
-  "version": "2.2.2",
-  "description": "DeukAgentRules: generic AGENTS.md + .cursor rule templates with init/merge CLI (npm name: deuk-agent-rule).",
-  "keywords": [
-    "agents-md",
-    "cursor-rules",
-    "copilot",
-    "gemini",
-    "claude",
-    "windsurf",
-    "jetbrains",
-    "ticket",
-    "deuk-family",
-    "deukpack-ecosystem"
-  ],
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/joygram/DeukAgentRules.git"
-  },
-  "bugs": {
-    "url": "https://github.com/joygram/DeukAgentRules/issues"
-  },
-  "homepage": "https://github.com/joygram/DeukAgentRules#readme",
-  "files": [
-    "bundle/**/*",
-    "scripts/**/*.mjs",
-    "README.md",
-    "README.ko.md",
-    "CHANGELOG.md"
-  ],
-  "scripts": {
-    "sync": "node scripts/sync-bundle.mjs",
-    "prepack": "node scripts/sync-bundle.mjs",
-    "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",
-    "sync:oss": "node scripts/sync-oss.mjs"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "bin": {
-    "deuk-agent-rule": "./scripts/cli.mjs"
-  },
-  "devDependencies": {
-    "commit-and-tag-version": "^12.7.1"
-  }
-}
+{
+  "name": "deuk-agent-rule",
+  "version": "2.3.2",
+  "description": "DeukAgentRules: generic AGENTS.md + .cursor rule templates with init/merge CLI (npm name: deuk-agent-rule).",
+  "keywords": [
+    "agents-md",
+    "cursor-rules",
+    "copilot",
+    "gemini",
+    "claude",
+    "windsurf",
+    "jetbrains",
+    "ticket",
+    "deuk-family",
+    "deukpack-ecosystem"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joygram/DeukAgentRules.git"
+  },
+  "bugs": {
+    "url": "https://github.com/joygram/DeukAgentRules/issues"
+  },
+  "homepage": "https://github.com/joygram/DeukAgentRules#readme",
+  "files": [
+    "bundle/**/*",
+    "scripts/**/*.mjs",
+    "README.md",
+    "README.ko.md",
+    "CHANGELOG.md",
+    "CHANGELOG.ko.md"
+  ],
+  "scripts": {
+    "sync": "node scripts/sync-bundle.mjs",
+    "prepack": "node scripts/sync-bundle.mjs",
+    "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",
+    "sync:oss": "node scripts/sync-oss.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "deuk-agent-rule": "./scripts/cli.mjs"
+  },
+  "devDependencies": {
+    "commit-and-tag-version": "^12.7.1"
+  },
+  "dependencies": {
+    "ejs": "^5.0.2",
+    "yaml": "^2.8.3"
+  }
+}

package/scripts/cli-args.mjs

@@ -12,6 +12,7 @@ export function parseTicketArgs(argv) {
     else if (a === "--from") out.from = argv[++i];
     else if (a === "--ref") out.ref = argv[++i];
     else if (a === "--limit") out.limit = Number(argv[++i]);
+    else if (a === "--submodule") out.submodule = argv[++i];
     else if (a === "--latest") out.latest = true;
     else if (a === "--path-only") out.pathOnly = true;
     else if (a === "--print-content") out.printContent = true;
@@ -19,6 +20,10 @@ export function parseTicketArgs(argv) {
     else if (a === "--status") out.status = argv[++i];
     else if (a === "--archived") out.archived = true;
     else if (a === "--report") out.report = argv[++i];
+    else if (a === "--json") out.json = true;
+    else if (a === "--remote") out.remote = argv[++i];
+    else if (a === "--sync") out.sync = true;
+    else if (a === "--no-sync") out.sync = false;
   }
   return out;
 }
@@ -39,6 +44,10 @@ export function parseArgs(argv) {
     else if (a === "--rules") out.rules = argv[++i];
     else if (a === "--cursorrules") out.cursorrules = argv[++i];
     else if (a === "--append-if-no-markers") out.appendIfNoMarkers = true;
+    else if (a === "--json") out.json = true;
+    else if (a === "--remote") out.remote = argv[++i];
+    else if (a === "--sync") out.sync = true;
+    else if (a === "--no-sync") out.sync = false;
     else if (a === "-h" || a === "--help") out.help = true;
   }
   return out;

package/scripts/cli-init-commands.mjs

@@ -1,8 +1,25 @@
 import { join } from "path";
-import { existsSync, readFileSync, writeFileSync } from "fs";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, readdirSync } from "fs";
 import { resolveMarkers, resolveCursorrulesMarkers, applyAgents, applyRules, applyCursorrules, readBundleAgents } from "./merge-logic.mjs";
 import { ensureTicketDirAndGitignore } from "./cli-init-logic.mjs";
-import { loadInitConfig, writeInitConfig } from "./cli-prompts.mjs";
+import { loadInitConfig, writeInitConfig } from "./cli-utils.mjs";
+import { runInteractive } from "./cli-prompts.mjs";
+
+function syncTemplates(cwd, bundleRoot, dryRun) {
+  const tplSrcDir = join(bundleRoot, "templates");
+  const tplDestDir = join(cwd, ".deuk-agent-templates");
+  if (!existsSync(tplSrcDir)) return;
+  if (!dryRun) mkdirSync(tplDestDir, { recursive: true });
+
+  for (const name of readdirSync(tplSrcDir)) {
+    if (!name.endsWith(".md")) continue;
+    const src = join(tplSrcDir, name);
+    const dest = join(tplDestDir, name);
+    if (!dryRun) copyFileSync(src, dest);
+    console.log(`template synced: ${dest}`);
+  }
+}
+
 
 export async function runInit(opts, bundleRoot) {
   const markers = resolveMarkers(opts);
@@ -33,6 +50,12 @@ export async function runInit(opts, bundleRoot) {
   console.log(`.cursorrules: ${crResult.action} (${crResult.mode || ""})`);
 
   ensureTicketDirAndGitignore(opts);
+  syncTemplates(opts.cwd, bundleRoot, opts.dryRun);
+
+  // If no config exists, save the derived/default config to ensure persistency
+  if (!loadInitConfig(opts.cwd)) {
+    writeInitConfig(opts.cwd, opts);
+  }
 }
 
 export function runMerge(opts, bundleRoot) {
@@ -62,4 +85,6 @@ export function runMerge(opts, bundleRoot) {
     dryRun: opts.dryRun, backup: opts.backup
   });
   console.log(`.cursorrules: ${crResult.action} (${crResult.mode || ""})`);
+
+  syncTemplates(opts.cwd, bundleRoot, opts.dryRun);
 }

package/scripts/cli-init-logic.mjs

@@ -12,6 +12,10 @@ export function ensureTicketDirAndGitignore(opts) {
   if (opts.dryRun) return;
 
   mkdirSync(ticketPath, { recursive: true });
+  if (opts.shareTickets) {
+    console.log(`[INIT] Ticket sharing enabled. Skipping .gitignore entry for ${TICKET_DIR_NAME}/`);
+    return;
+  }
 
   let gi = existsSync(gitignorePath) ? readFileSync(gitignorePath, "utf8") : "";
   if (!gi.includes(ignoreLine)) {

package/scripts/cli-prompts.mjs

@@ -1,9 +1,7 @@
 import { createInterface } from "readline";
-import { existsSync, readFileSync, writeFileSync } from "fs";
+import { existsSync, readFileSync } from "fs";
 import { join } from "path";
-
-const INIT_CONFIG_FILENAME = ".deuk-agent-rule.config.json";
-const INIT_CONFIG_VERSION = 1;
+import { loadInitConfig, writeInitConfig, STACKS, AGENT_TOOLS } from "./cli-utils.mjs";
 
 export async function ask(rl, question) {
   return new Promise((resolve) => rl.question(question, resolve));
@@ -41,48 +39,7 @@ export async function selectMany(rl, prompt, choices) {
   }
 }
 
-export function loadInitConfig(cwd) {
-  const p = join(cwd, INIT_CONFIG_FILENAME);
-  if (!existsSync(p)) return null;
-  try {
-    const j = JSON.parse(readFileSync(p, "utf8"));
-    if (j.version !== INIT_CONFIG_VERSION) return null;
-    return j;
-  } catch {
-    return null;
-  }
-}
-
-export function writeInitConfig(cwd, opts) {
-  const p = join(cwd, INIT_CONFIG_FILENAME);
-  const body = {
-    version: INIT_CONFIG_VERSION,
-    stack: opts.stack,
-    agentTools: opts.agentTools,
-    agentsMode: opts.agents ?? "inject",
-    updatedAt: new Date().toISOString(),
-  };
-  writeFileSync(p, JSON.stringify(body, null, 2) + "\n", "utf8");
-}
-
-export const STACKS = [
-  { label: "Unity / C#", value: "unity" },
-  { label: "Next.js + C#", value: "nextjs-dotnet" },
-  { label: "Web (React / Vue / general)", value: "web" },
-  { label: "Java / Spring Boot", value: "java" },
-  { label: "Other / skip", value: "other" },
-];
 
-export const AGENT_TOOLS = [
-  { label: "Cursor", value: "cursor" },
-  { label: "GitHub Copilot", value: "copilot" },
-  { label: "Gemini / Antigravity", value: "gemini" },
-  { label: "Claude (Cursor / Claude Code)", value: "claude" },
-  { label: "Windsurf", value: "windsurf" },
-  { label: "JetBrains AI Assistant", value: "jetbrains" },
-  { label: "All of the above", value: "all" },
-  { label: "Other / skip", value: "other" },
-];
 
 export async function runInteractive(opts) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -91,6 +48,7 @@ export async function runInteractive(opts) {
 
     const stack = await selectOne(rl, "What is your primary tech stack?", STACKS);
     const tools = await selectMany(rl, "Which agent tools do you use?", AGENT_TOOLS);
+    const shareTickets = await askYesNo("Do you want to share (git-track) tickets for this repository?", false);
 
     const targetAgents = join(opts.cwd, "AGENTS.md");
     let agentsDefault = "inject";
@@ -110,12 +68,26 @@ export async function runInteractive(opts) {
       }
     }
 
+    const remoteSync = opts.remoteSync !== undefined ? opts.remoteSync : (await askYesNo("Enable AI Pipeline remote synchronization? (Advanced)", false));
+    let pipelineUrl = opts.pipelineUrl || "";
+    if (remoteSync && !pipelineUrl) {
+      pipelineUrl = (await ask(rl, "Enter AI Pipeline Endpoint URL: ")).trim();
+    }
+
     opts.agents = opts.agents ?? agentsDefault;
     opts.stack = stack;
     opts.agentTools = tools;
+    opts.shareTickets = shareTickets;
+    opts.remoteSync = remoteSync;
+    opts.pipelineUrl = pipelineUrl;
+
+    writeInitConfig(opts.cwd, opts);
 
     console.log("\n  Stack : " + stack);
     console.log("  Tools : " + (tools.join(", ") || "none"));
+    console.log("  Share Tickets: " + (opts.shareTickets ? "Yes (Shared)" : "No (Private)"));
+    console.log("  Remote Sync:   " + (opts.remoteSync ? "Enabled" : "Disabled"));
+    if (opts.remoteSync) console.log("  Pipeline URL:  " + opts.pipelineUrl);
     console.log("  AGENTS: " + opts.agents + "\n");
   } finally {
     rl.close();

package/scripts/cli-ticket-commands.mjs

@@ -1,7 +1,9 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync, copyFileSync, readdirSync, rmSync, statSync } from "fs";
 import { basename, join, dirname, relative, resolve } from "path";
-import { toSlug, toRepoRelativePath, inferRefTitleAndTopic, resolveReferencedTicketPath, toPosixPath } from "./cli-utils.mjs";
-import { TICKET_DIR_NAME, appendTicketEntry, rebuildTicketIndexFromTopicFilesIfNeeded, detectConsumerTicketDir, readTicketIndexJson, writeTicketIndexJson, writeTicketListFile } from "./cli-ticket-logic.mjs";
+import { toSlug, toRepoRelativePath, inferRefTitleAndTopic, resolveReferencedTicketPath, toPosixPath, stringifyFrontMatter } from "./cli-utils.mjs";
+import { TICKET_DIR_NAME, appendTicketEntry, rebuildTicketIndexFromTopicFilesIfNeeded, detectConsumerTicketDir, readTicketIndexJson, writeTicketIndexJson, writeTicketListFile, syncActiveTicketPointer, generateTicketId, syncToPipeline } from "./cli-ticket-logic.mjs";
+import { loadInitConfig } from "./cli-utils.mjs";
+import ejs from "ejs";
 
 import { createInterface } from "readline";
 import { selectOne } from "./cli-prompts.mjs";
@@ -19,21 +21,60 @@ export async function runTicketCreate(opts) {
     path = resolveReferencedTicketPath(opts);
     source = "ticket-reference";
   } else {
-    let body = opts.content ? String(opts.content).replace(/\\n/g, '\n') : "";
-    if (!body && opts.from) body = readFileSync(join(opts.cwd, opts.from), "utf8");
-    const abs = join(opts.cwd, TICKET_DIR_NAME, group, `${topic}-${Date.now()}.md`);
-    mkdirSync(join(opts.cwd, TICKET_DIR_NAME, group), { recursive: true });
+    let tplText = "";
+    const consumerTplPath = join(opts.cwd, ".deuk-agent-templates", "TICKET_TEMPLATE.md");
+    const bundleTplPath = join(new URL('.', import.meta.url).pathname, "..", "bundle", "templates", "TICKET_TEMPLATE.md");
+    
+    if (existsSync(consumerTplPath)) tplText = readFileSync(consumerTplPath, "utf8");
+    else if (existsSync(bundleTplPath)) tplText = readFileSync(bundleTplPath, "utf8");
+    else throw new Error("ticket create: Template not found. Refusing to create an empty ticket.");
+
+    // Find nearest or create in CWD if missing
+    const ticketDir = detectConsumerTicketDir(opts.cwd, { createIfMissing: true });
+    const abs = join(ticketDir, group, `${topic}-${Date.now()}.md`);
+    mkdirSync(join(ticketDir, group), { recursive: true });
     path = toRepoRelativePath(opts.cwd, abs);
-    const marker = `\n\n<!-- Ticket (repo-relative): ${path} -->\n`;
-    writeFileSync(abs, body.trimEnd() + marker, "utf8");
+
+    const ticketId = generateTicketId(title);
+    const meta = {
+      id: ticketId,
+      title,
+      topic,
+      status: "open",
+      submodule: opts.submodule || "",
+      project: opts.project || "global",
+      createdAt: new Date().toISOString(),
+    };
+
+    const ejsFrontMatter = `---
+id: <%= meta.id %>
+title: "<%- meta.title.replace(/"/g, '\\"') %>"
+topic: <%= meta.topic %>
+status: open
+submodule: <%= meta.submodule %>
+project: <%= meta.project %>
+createdAt: <%= meta.createdAt %>
+---
+
+`;
+    const finalContent = ejs.render(ejsFrontMatter + tplText, { meta });
+    writeFileSync(abs, finalContent, "utf8");
     source = "ticket-create";
+    
+    // Remote Sync Hook
+    const config = loadInitConfig(opts.cwd);
+    if (config && config.remoteSync && config.pipelineUrl) {
+      syncToPipeline(config.pipelineUrl, { action: "create", ticket: meta });
+    }
+
+    appendTicketEntry(opts.cwd, {
+      id: ticketId,
+      title, topic, group, project: opts.project || "global",
+      createdAt: new Date().toISOString(), path, source
+    }, opts);
   }
 
-  appendTicketEntry(opts.cwd, {
-    id: `ticket_${Date.now()}`,
-    title, topic, group, project: opts.project || "global",
-    createdAt: new Date().toISOString(), path, source
-  }, opts);
+  syncActiveTicketPointer(opts.cwd);
 }
 
 export async function runTicketList(opts) {
@@ -42,24 +83,64 @@ export async function runTicketList(opts) {
     throw new Error("No ticket system found. Please run 'npx deuk-agent-rule init' first.");
   }
   const index = rebuildTicketIndexFromTopicFilesIfNeeded(opts.cwd, opts);
+  syncActiveTicketPointer(opts.cwd);
   let rows = index.entries;
+
   
-  if (!opts.all) {
-    const targetStatus = opts.status || "open";
-    rows = rows.filter(e => e.status === targetStatus);
+  if (opts.active) {
+    rows = rows.filter(e => e.status === "active" || e.status === "open");
+  } else if (opts.archived) {
+    rows = rows.filter(e => e.status === "archived");
+  } else if (!opts.all) {
+    // Default: major/active list (open or active)
+    rows = rows.filter(e => e.status === "open" || e.status === "active");
   }
   
   if (opts.group) rows = rows.filter(e => e.group === opts.group);
   if (opts.project) rows = rows.filter(e => e.project === opts.project);
+  if (opts.submodule) rows = rows.filter(e => e.submodule === opts.submodule);
   
-  console.log("#  STATUS  GROUP       PROJECT     CREATED                  TITLE");
+  if (opts.json) {
+    console.log(JSON.stringify(rows, null, 2));
+    return;
+  }
+
+  console.log("#  STATUS   SUBMODULE   GROUP       PROJECT     CREATED                  TITLE");
   rows.slice(0, opts.limit).forEach((e, idx) => {
     const stat = (e.status === "closed" ? "[x]" : "[ ]").padEnd(7);
+    const sub = (e.submodule || "-").padEnd(11);
     const safeTitle = String(e.title || e.topic || "").replace(/(\n|\\n)+/g, " ").slice(0, 50);
-    console.log(`${String(idx+1).padEnd(2)} ${stat} ${e.group.padEnd(10)} ${e.project.padEnd(11)} ${e.createdAt.padEnd(24)} ${safeTitle}`);
+    console.log(`${String(idx+1).padEnd(2)} ${stat} ${sub} ${String(e.group||"").padEnd(10)} ${String(e.project||"").padEnd(11)} ${String(e.createdAt||"").padEnd(24)} ${safeTitle}`);
   });
 }
 
+export async function runTicketMeta(opts) {
+  const index = rebuildTicketIndexFromTopicFilesIfNeeded(opts.cwd, opts);
+  const found = pickTicketEntry(opts, index);
+  if (!found) throw new Error("ticket meta: no matching ticket found");
+
+  if (opts.json) {
+    console.log(JSON.stringify(found, null, 2));
+  } else {
+    console.log(`Ticket Meta [${found.topic}]`);
+    Object.entries(found).forEach(([k, v]) => console.log(`  ${k}: ${v}`));
+  }
+}
+
+export async function runTicketConnect(opts) {
+  const config = loadInitConfig(opts.cwd);
+  const url = opts.remote || config?.pipelineUrl;
+  if (!url) throw new Error("ticket connect: no pipeline URL configured or provided via --remote");
+
+  console.log(`Connecting to AI Pipeline at ${url} ...`);
+  const success = await syncToPipeline(url, { action: "ping", timestamp: new Date().toISOString() });
+  if (success) {
+    console.log("SUCCESS: Pipeline is reachable.");
+  } else {
+    console.error("FAILED: Could not connect to pipeline or returned non-OK status.");
+  }
+}
+
 import { updateTicketEntryStatus } from "./cli-ticket-logic.mjs";
 
 export async function runTicketClose(opts) {
@@ -85,6 +166,7 @@ export async function runTicketClose(opts) {
   }
   opts.status = "closed";
   const entry = updateTicketEntryStatus(opts.cwd, opts);
+  syncActiveTicketPointer(opts.cwd);
   console.log(`ticket: closed -> ${entry.topic} (${entry.path})`);
 }
 
@@ -117,45 +199,7 @@ export async function runTicketUse(opts) {
   }
 }
 
-import { getLegacyMigrationCandidate, parseLegacyTicketMeta } from "./cli-ticket-logic.mjs";
 
-export async function runTicketMigrate(opts) {
-  const candidate = getLegacyMigrationCandidate(opts.cwd);
-  if (!candidate) {
-    console.log("ticket: no legacy LATEST.md migration candidate found");
-    return;
-  }
-
-  const { title, group, project } = parseLegacyTicketMeta(candidate.body);
-  const topic = toSlug(title);
-  const stamp = Date.now();
-  const relPath = join(TICKET_DIR_NAME, group, `${topic}-${stamp}.md`);
-  const absPath = join(opts.cwd, relPath);
-
-  if (opts.dryRun) {
-    console.log("ticket: would migrate -> " + relPath);
-  } else {
-    mkdirSync(dirname(absPath), { recursive: true });
-    const marker = `\n\n<!-- Ticket (repo-relative): ${relPath} -->\n`;
-    writeFileSync(absPath, candidate.body.trimEnd() + marker, "utf8");
-    console.log("ticket: migrated body -> " + relPath);
-
-    appendTicketEntry(opts.cwd, {
-      id: `ticket_migrated_${stamp}`,
-      title,
-      topic,
-      group,
-      project,
-      createdAt: new Date().toISOString(),
-      path: relPath,
-      source: "ticket-migrate",
-    }, opts);
-    if (existsSync(candidate.latestPath)) {
-      unlinkSync(candidate.latestPath);
-      console.log("ticket: deleted legacy LATEST.md");
-    }
-  }
-}
 
 export function pickTicketEntry(opts, indexJson) {
   const rows = [...indexJson.entries].sort((a, b) => String(b.createdAt || "").localeCompare(String(a.createdAt || "")));