deuk-agent-rule 2.2.0 → 2.2.1

package/scripts/cli-prompts.mjs

@@ -1,123 +1,123 @@
-import { createInterface } from "readline";
-import { existsSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
-
-const INIT_CONFIG_FILENAME = ".deuk-agent-rule.config.json";
-const INIT_CONFIG_VERSION = 1;
-
-export async function ask(rl, question) {
-  return new Promise((resolve) => rl.question(question, resolve));
-}
-
-export async function askYesNo(question, defaultYes = true) {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  try {
-    const ans = (await ask(rl, question + (defaultYes ? " [Y/n]: " : " [y/N]: "))).trim().toLowerCase();
-    if (!ans) return defaultYes;
-    return ans === "y" || ans === "yes";
-  } finally {
-    rl.close();
-  }
-}
-
-export async function selectOne(rl, prompt, choices) {
-  console.log("\n" + prompt);
-  choices.forEach((c, i) => console.log(`  ${i + 1}) ${c.label}`));
-  while (true) {
-    const ans = (await ask(rl, `  Choice [1-${choices.length}]: `)).trim();
-    const idx = parseInt(ans, 10) - 1;
-    if (idx >= 0 && idx < choices.length) return choices[idx].value;
-  }
-}
-
-export async function selectMany(rl, prompt, choices) {
-  console.log("\n" + prompt + " (comma-separated numbers, or 'all')");
-  choices.forEach((c, i) => console.log(`  ${i + 1}) ${c.label}`));
-  while (true) {
-    const ans = (await ask(rl, `  Choices: `)).trim().toLowerCase();
-    if (ans === "all" || ans === "") return choices.map((c) => c.value);
-    const parts = ans.split(/[,\s]+/).map((s) => parseInt(s, 10) - 1);
-    if (parts.every((i) => i >= 0 && i < choices.length)) return parts.map((i) => choices[i].value);
-  }
-}
-
-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 });
-  try {
-    console.log("\nDeukAgentRules init — let's configure your workspace.\n");
-
-    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 targetAgents = join(opts.cwd, "AGENTS.md");
-    let agentsDefault = "inject";
-    if (!existsSync(targetAgents)) {
-      agentsDefault = "inject"; // will append markers
-      console.log("\n  No AGENTS.md found — will create with markers.");
-    } else {
-      const content = readFileSync(targetAgents, "utf8");
-      const hasMarkers = content.includes("deuk-agent-rule:begin");
-      if (!hasMarkers) {
-        const choice = await selectOne(rl, "AGENTS.md exists but has no markers. How to apply?", [
-          { label: "Append managed block at the end (safe)", value: "inject" },
-          { label: "Overwrite entire AGENTS.md", value: "overwrite" },
-          { label: "Skip AGENTS.md", value: "skip" },
-        ]);
-        agentsDefault = choice;
-      }
-    }
-
-    opts.agents = opts.agents ?? agentsDefault;
-    opts.stack = stack;
-    opts.agentTools = tools;
-
-    console.log("\n  Stack : " + stack);
-    console.log("  Tools : " + (tools.join(", ") || "none"));
-    console.log("  AGENTS: " + opts.agents + "\n");
-  } finally {
-    rl.close();
-  }
-}
+import { createInterface } from "readline";
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+
+const INIT_CONFIG_FILENAME = ".deuk-agent-rule.config.json";
+const INIT_CONFIG_VERSION = 1;
+
+export async function ask(rl, question) {
+  return new Promise((resolve) => rl.question(question, resolve));
+}
+
+export async function askYesNo(question, defaultYes = true) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const ans = (await ask(rl, question + (defaultYes ? " [Y/n]: " : " [y/N]: "))).trim().toLowerCase();
+    if (!ans) return defaultYes;
+    return ans === "y" || ans === "yes";
+  } finally {
+    rl.close();
+  }
+}
+
+export async function selectOne(rl, prompt, choices) {
+  console.log("\n" + prompt);
+  choices.forEach((c, i) => console.log(`  ${i + 1}) ${c.label}`));
+  while (true) {
+    const ans = (await ask(rl, `  Choice [1-${choices.length}]: `)).trim();
+    const idx = parseInt(ans, 10) - 1;
+    if (idx >= 0 && idx < choices.length) return choices[idx].value;
+  }
+}
+
+export async function selectMany(rl, prompt, choices) {
+  console.log("\n" + prompt + " (comma-separated numbers, or 'all')");
+  choices.forEach((c, i) => console.log(`  ${i + 1}) ${c.label}`));
+  while (true) {
+    const ans = (await ask(rl, `  Choices: `)).trim().toLowerCase();
+    if (ans === "all" || ans === "") return choices.map((c) => c.value);
+    const parts = ans.split(/[,\s]+/).map((s) => parseInt(s, 10) - 1);
+    if (parts.every((i) => i >= 0 && i < choices.length)) return parts.map((i) => choices[i].value);
+  }
+}
+
+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 });
+  try {
+    console.log("\nDeukAgentRules init — let's configure your workspace.\n");
+
+    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 targetAgents = join(opts.cwd, "AGENTS.md");
+    let agentsDefault = "inject";
+    if (!existsSync(targetAgents)) {
+      agentsDefault = "inject"; // will append markers
+      console.log("\n  No AGENTS.md found — will create with markers.");
+    } else {
+      const content = readFileSync(targetAgents, "utf8");
+      const hasMarkers = content.includes("deuk-agent-rule:begin");
+      if (!hasMarkers) {
+        const choice = await selectOne(rl, "AGENTS.md exists but has no markers. How to apply?", [
+          { label: "Append managed block at the end (safe)", value: "inject" },
+          { label: "Overwrite entire AGENTS.md", value: "overwrite" },
+          { label: "Skip AGENTS.md", value: "skip" },
+        ]);
+        agentsDefault = choice;
+      }
+    }
+
+    opts.agents = opts.agents ?? agentsDefault;
+    opts.stack = stack;
+    opts.agentTools = tools;
+
+    console.log("\n  Stack : " + stack);
+    console.log("  Tools : " + (tools.join(", ") || "none"));
+    console.log("  AGENTS: " + opts.agents + "\n");
+  } finally {
+    rl.close();
+  }
+}

package/scripts/cli-ticket-commands.mjs

@@ -1,159 +1,159 @@
-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 { createInterface } from "readline";
-import { selectOne } from "./cli-prompts.mjs";
-
-export async function runTicketCreate(opts) {
-  if (!opts.topic && !opts.ref) throw new Error("ticket create requires --topic or --ref");
-  
-  const inferred = opts.ref ? inferRefTitleAndTopic(opts) : null;
-  const topic = toSlug(opts.topic || inferred?.topic || "ticket");
-  const title = opts.topic || inferred?.title || "ticket";
-  const group = toSlug(opts.group || "sub");
-
-  let path, source;
-  if (opts.ref) {
-    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 });
-    path = toRepoRelativePath(opts.cwd, abs);
-    const marker = `\n\n<!-- Ticket (repo-relative): ${path} -->\n`;
-    writeFileSync(abs, body.trimEnd() + marker, "utf8");
-    source = "ticket-create";
-  }
-
-  appendTicketEntry(opts.cwd, {
-    id: `ticket_${Date.now()}`,
-    title, topic, group, project: opts.project || "global",
-    createdAt: new Date().toISOString(), path, source
-  }, opts);
-}
-
-export async function runTicketList(opts) {
-  const ticketDir = detectConsumerTicketDir(opts.cwd);
-  if (!ticketDir) {
-    throw new Error("No ticket system found. Please run 'npx deuk-agent-rule init' first.");
-  }
-  const index = rebuildTicketIndexFromTopicFilesIfNeeded(opts.cwd, opts);
-  let rows = index.entries;
-  
-  if (!opts.all) {
-    const targetStatus = opts.status || "open";
-    rows = rows.filter(e => e.status === targetStatus);
-  }
-  
-  if (opts.group) rows = rows.filter(e => e.group === opts.group);
-  if (opts.project) rows = rows.filter(e => e.project === opts.project);
-  
-  console.log("#  STATUS  GROUP       PROJECT     CREATED                  TITLE");
-  rows.slice(0, opts.limit).forEach((e, idx) => {
-    const stat = (e.status === "closed" ? "[x]" : "[ ]").padEnd(7);
-    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}`);
-  });
-}
-
-import { updateTicketEntryStatus } from "./cli-ticket-logic.mjs";
-
-export async function runTicketClose(opts) {
-  if (!opts.topic && !opts.latest) {
-    if (process.stdout.isTTY) {
-      const index = rebuildTicketIndexFromTopicFilesIfNeeded(opts.cwd, opts);
-      const choices = index.entries
-        .filter(e => e.status !== "closed")
-        .map(e => ({ label: `[${e.group}] ${e.title}`, value: e.topic }));
-      if (choices.length > 0) {
-        const rl = createInterface({ input: process.stdin, output: process.stdout });
-        try {
-          opts.topic = await selectOne(rl, "Choose a ticket to close:", choices);
-        } finally {
-          rl.close();
-        }
-      } else {
-        throw new Error("No open tickets found to close.");
-      }
-    } else {
-      throw new Error("ticket close requires --topic or --latest");
-    }
-  }
-  opts.status = "closed";
-  const entry = updateTicketEntryStatus(opts.cwd, opts);
-  console.log(`ticket: closed -> ${entry.topic} (${entry.path})`);
-}
-
-export async function runTicketUse(opts) {
-  const index = rebuildTicketIndexFromTopicFilesIfNeeded(opts.cwd, opts);
-  
-  let targetTopic = opts.topic;
-  if (!targetTopic && !opts.latest) {
-    if (process.stdout.isTTY) {
-      const choices = index.entries
-        .map(e => ({ label: `${e.status === 'closed' ? '✓ ' : ''}[${e.group}] ${e.title}`, value: e.topic }));
-      if (choices.length > 0) {
-        const rl = createInterface({ input: process.stdin, output: process.stdout });
-        try {
-          targetTopic = await selectOne(rl, "Choose a ticket to use:", choices);
-        } finally {
-          rl.close();
-        }
-      }
-    }
-  }
-
-  const found = opts.latest ? index.entries[0] : index.entries.find(e => e.topic.includes(targetTopic));
-  if (!found) throw new Error("No matching ticket found");
-  
-  if (opts.pathOnly) console.log(found.path);
-  else {
-    console.log(`Path: ${found.path}`);
-    if (opts.printContent) console.log("\n" + readFileSync(join(opts.cwd, found.path), "utf8"));
-  }
-}
-
-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;
-  }
-
-  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");
-    }
-  }
-}
+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 { createInterface } from "readline";
+import { selectOne } from "./cli-prompts.mjs";
+
+export async function runTicketCreate(opts) {
+  if (!opts.topic && !opts.ref) throw new Error("ticket create requires --topic or --ref");
+  
+  const inferred = opts.ref ? inferRefTitleAndTopic(opts) : null;
+  const topic = toSlug(opts.topic || inferred?.topic || "ticket");
+  const title = opts.topic || inferred?.title || "ticket";
+  const group = toSlug(opts.group || "sub");
+
+  let path, source;
+  if (opts.ref) {
+    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 });
+    path = toRepoRelativePath(opts.cwd, abs);
+    const marker = `\n\n<!-- Ticket (repo-relative): ${path} -->\n`;
+    writeFileSync(abs, body.trimEnd() + marker, "utf8");
+    source = "ticket-create";
+  }
+
+  appendTicketEntry(opts.cwd, {
+    id: `ticket_${Date.now()}`,
+    title, topic, group, project: opts.project || "global",
+    createdAt: new Date().toISOString(), path, source
+  }, opts);
+}
+
+export async function runTicketList(opts) {
+  const ticketDir = detectConsumerTicketDir(opts.cwd);
+  if (!ticketDir) {
+    throw new Error("No ticket system found. Please run 'npx deuk-agent-rule init' first.");
+  }
+  const index = rebuildTicketIndexFromTopicFilesIfNeeded(opts.cwd, opts);
+  let rows = index.entries;
+  
+  if (!opts.all) {
+    const targetStatus = opts.status || "open";
+    rows = rows.filter(e => e.status === targetStatus);
+  }
+  
+  if (opts.group) rows = rows.filter(e => e.group === opts.group);
+  if (opts.project) rows = rows.filter(e => e.project === opts.project);
+  
+  console.log("#  STATUS  GROUP       PROJECT     CREATED                  TITLE");
+  rows.slice(0, opts.limit).forEach((e, idx) => {
+    const stat = (e.status === "closed" ? "[x]" : "[ ]").padEnd(7);
+    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}`);
+  });
+}
+
+import { updateTicketEntryStatus } from "./cli-ticket-logic.mjs";
+
+export async function runTicketClose(opts) {
+  if (!opts.topic && !opts.latest) {
+    if (process.stdout.isTTY) {
+      const index = rebuildTicketIndexFromTopicFilesIfNeeded(opts.cwd, opts);
+      const choices = index.entries
+        .filter(e => e.status !== "closed")
+        .map(e => ({ label: `[${e.group}] ${e.title}`, value: e.topic }));
+      if (choices.length > 0) {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        try {
+          opts.topic = await selectOne(rl, "Choose a ticket to close:", choices);
+        } finally {
+          rl.close();
+        }
+      } else {
+        throw new Error("No open tickets found to close.");
+      }
+    } else {
+      throw new Error("ticket close requires --topic or --latest");
+    }
+  }
+  opts.status = "closed";
+  const entry = updateTicketEntryStatus(opts.cwd, opts);
+  console.log(`ticket: closed -> ${entry.topic} (${entry.path})`);
+}
+
+export async function runTicketUse(opts) {
+  const index = rebuildTicketIndexFromTopicFilesIfNeeded(opts.cwd, opts);
+  
+  let targetTopic = opts.topic;
+  if (!targetTopic && !opts.latest) {
+    if (process.stdout.isTTY) {
+      const choices = index.entries
+        .map(e => ({ label: `${e.status === 'closed' ? '✓ ' : ''}[${e.group}] ${e.title}`, value: e.topic }));
+      if (choices.length > 0) {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        try {
+          targetTopic = await selectOne(rl, "Choose a ticket to use:", choices);
+        } finally {
+          rl.close();
+        }
+      }
+    }
+  }
+
+  const found = opts.latest ? index.entries[0] : index.entries.find(e => e.topic.includes(targetTopic));
+  if (!found) throw new Error("No matching ticket found");
+  
+  if (opts.pathOnly) console.log(found.path);
+  else {
+    console.log(`Path: ${found.path}`);
+    if (opts.printContent) console.log("\n" + readFileSync(join(opts.cwd, found.path), "utf8"));
+  }
+}
+
+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;
+  }
+
+  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");
+    }
+  }
+}