deuk-agent-rule 2.2.1 → 2.3.1

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "deuk-agent-rule",
-  "version": "2.2.1",
-  "type": "module",
-  "description": "DeukAgentRules",
+  "version": "2.3.1",
+  "description": "DeukAgentRules: generic AGENTS.md + .cursor rule templates with init/merge CLI (npm name: deuk-agent-rule).",
   "keywords": [
     "agents-md",
     "cursor-rules",
@@ -49,5 +48,8 @@
   },
   "devDependencies": {
     "commit-and-tag-version": "^12.7.1"
+  },
+  "dependencies": {
+    "ejs": "^5.0.2"
   }
 }

package/scripts/cli-args.mjs

@@ -12,11 +12,18 @@ 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;
     else if (a === "--all") out.all = true;
     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;
 }
@@ -37,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 } from "fs";
-import { basename, join } from "path";
-import { toSlug, toRepoRelativePath, inferRefTitleAndTopic, resolveReferencedTicketPath } from "./cli-utils.mjs";
-import { TICKET_DIR_NAME, appendTicketEntry, rebuildTicketIndexFromTopicFilesIfNeeded, detectConsumerTicketDir } from "./cli-ticket-logic.mjs";
+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, 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,43 +199,115 @@ export async function runTicketUse(opts) {
   }
 }
 
-import { getLegacyMigrationCandidate, parseLegacyTicketMeta } from "./cli-ticket-logic.mjs";
-import { dirname } from "path";
 
-export async function runTicketMigrate(opts) {
-  const candidate = getLegacyMigrationCandidate(opts.cwd);
-  if (!candidate) {
-    console.log("ticket: no legacy LATEST.md migration candidate found");
-    return;
+
+export function pickTicketEntry(opts, indexJson) {
+  const rows = [...indexJson.entries].sort((a, b) => String(b.createdAt || "").localeCompare(String(a.createdAt || "")));
+  if (rows.length === 0) return null;
+  if (opts.topic) {
+    const key = String(opts.topic).toLowerCase();
+    return rows.find(e => String(e.topic || "").toLowerCase().includes(key)) || null;
   }
+  return rows[0];
+}
 
-  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);
+export async function runTicketArchive(opts) {
+  if (!opts.latest && !opts.topic) {
+    if (process.stdout.isTTY) {
+      const index = rebuildTicketIndexFromTopicFilesIfNeeded(opts.cwd, opts);
+      const choices = index.entries
+        .filter(e => e.status !== "archived")
+        .map(e => ({ label: `[${e.group}] ${e.title}`, value: e.topic }));
+      if (choices.length > 0) {
+        const { createInterface } = await import("readline");
+        const { selectOne } = await import("./cli-prompts.mjs");
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        try {
+          opts.topic = await selectOne(rl, "Choose a ticket to archive (this will move the file to archive/):", choices);
+        } finally {
+          rl.close();
+        }
+      } else {
+        throw new Error("No active tickets found to archive.");
+      }
+    } else {
+      throw new Error("ticket archive requires --latest or --topic <prefix>");
+    }
+  }
+  
+  const indexJson = rebuildTicketIndexFromTopicFilesIfNeeded(opts.cwd, opts);
+  const found = pickTicketEntry(opts, indexJson);
+  if (!found) throw new Error("ticket archive: no matching entry");
 
-  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);
+  const absPath = join(opts.cwd, found.path);
+  if (!existsSync(absPath)) {
+    throw new Error("ticket archive: file not found " + found.path);
+  }
 
-    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");
+  const archiveDir = join(opts.cwd, TICKET_DIR_NAME, "archive", found.group || "sub");
+  if (!opts.dryRun) mkdirSync(archiveDir, { recursive: true });
+  
+  const fileName = found.path.split(/[/\\]/).pop();
+  const newAbsPath = join(archiveDir, fileName);
+  const bodyLines = readFileSync(absPath, "utf8").trimEnd().split(/\r?\n/);
+  
+  if (opts.report) {
+    const reportSrc = resolve(opts.cwd, opts.report);
+    if (!existsSync(reportSrc)) {
+      throw new Error("ticket archive: report file not found " + opts.report);
     }
+    const reportDir = join(opts.cwd, TICKET_DIR_NAME, "reports");
+    if (!opts.dryRun) mkdirSync(reportDir, { recursive: true });
+    
+    const reportDest = join(reportDir, `REPORT-${fileName}`);
+    if (!opts.dryRun) copyFileSync(reportSrc, reportDest);
+    console.log("ticket archive: copied report to " + toRepoRelativePath(opts.cwd, reportDest));
+    
+    bodyLines.push("");
+    bodyLines.push("## 📄 Attached Report");
+    const relativeLink = toPosixPath(relative(dirname(newAbsPath), reportDest));
+    bodyLines.push(`- [View Report](${relativeLink})`);
   }
+
+  if (opts.dryRun) {
+    console.log("ticket archive: would move " + toRepoRelativePath(opts.cwd, absPath) + " to " + toRepoRelativePath(opts.cwd, newAbsPath));
+    return;
+  }
+
+  writeFileSync(newAbsPath, bodyLines.join("\n") + "\n", "utf8");
+  rmSync(absPath);
+  console.log("ticket archive: moved ticket to " + toRepoRelativePath(opts.cwd, newAbsPath));
+
+  const entryIdx = indexJson.entries.findIndex(e => e.id === found.id);
+  if (entryIdx >= 0) {
+    indexJson.entries[entryIdx].status = "archived";
+    indexJson.entries[entryIdx].path = toRepoRelativePath(opts.cwd, newAbsPath);
+    indexJson.entries[entryIdx].updatedAt = new Date().toISOString();
+  }
+
+  writeTicketIndexJson(opts.cwd, indexJson, opts);
+  writeTicketListFile(opts.cwd, indexJson.entries, opts);
+}
+
+export async function runTicketReports(opts) {
+  const reportDir = join(opts.cwd, TICKET_DIR_NAME, "reports");
+  console.log("\n📄 Agent Reports:");
+  if (!existsSync(reportDir)) {
+    console.log("  No reports found.");
+    return;
+  }
+  const files = readdirSync(reportDir).filter(f => f.startsWith("REPORT-") && f.endsWith(".md"));
+  if (files.length === 0) {
+    console.log("  No reports found.");
+    return;
+  }
+  
+  const sorted = files.sort((a, b) => {
+    return statSync(join(reportDir, b)).mtime.getTime() - statSync(join(reportDir, a)).mtime.getTime();
+  });
+  
+  sorted.slice(0, opts.limit || 30).forEach(f => {
+    console.log(`  - [${f}]`);
+  });
+  console.log("");
 }