deuk-agent-flow 4.2.7 → 5.0.2

package/scripts/cli-init-logic.mjs

@@ -1,64 +0,0 @@
-import { existsSync, appendFileSync, writeFileSync, mkdirSync, readFileSync } from "fs";
-import { join } from "path";
-import { AGENT_ROOT_DIR, LEGACY_IGNORE_DIR, LEGACY_TICKET_DIR, LEGACY_TICKET_DIR_PLURAL, TICKET_DIR_NAME } from "./cli-utils.mjs";
-
-const GITIGNORE_AGENT_MARKER = "# deuk-agent-flow: agent hub directory (local, not committed by default)";
-const LEGACY_GITIGNORE_AGENT_MARKER = "# deuk-agent-rule: agent hub directory (local, not committed by default)";
-
-function hasExactGitignoreLine(content, line) {
-  return content
-    .split(/\r?\n/)
-    .map(s => s.trim())
-    .includes(line);
-}
-
-function removeExactGitignoreLines(content, lines) {
-  const remove = new Set(lines);
-  return content
-    .split(/\r?\n/)
-    .filter(line => !remove.has(line.trim()))
-    .join("\n");
-}
-
-export function ensureTicketDirAndGitignore(opts) {
-  const ticketPath = join(opts.cwd, TICKET_DIR_NAME);
-  const gitignorePath = join(opts.cwd, ".gitignore");
-  const ignoreLine = AGENT_ROOT_DIR + "/";
-
-  if (opts.dryRun) return;
-
-  mkdirSync(ticketPath, { recursive: true });
-  if (opts.shareTickets) {
-    console.log(`[INIT] Ticket sharing enabled. Skipping .gitignore entry for ${AGENT_ROOT_DIR}/`);
-    return;
-  }
-
-  let gi = existsSync(gitignorePath) ? readFileSync(gitignorePath, "utf8") : "";
-  
-  // 1. Create document directories
-  const docsPath = join(opts.cwd, AGENT_ROOT_DIR, "docs");
-  mkdirSync(join(docsPath, "plan"), { recursive: true });
-  mkdirSync(join(docsPath, "archive"), { recursive: true });
-
-  // Also check for legacy ignore lines to clean up or at least check presence
-  const legacyIgnore1 = `${LEGACY_TICKET_DIR}/`;
-  const legacyIgnore2 = `${LEGACY_TICKET_DIR_PLURAL}/`;
-  const legacyIgnore3 = LEGACY_IGNORE_DIR;
-  const cleanedGi = removeExactGitignoreLines(gi, [legacyIgnore1, legacyIgnore2, legacyIgnore3, LEGACY_GITIGNORE_AGENT_MARKER]);
-  if (cleanedGi !== gi) {
-    writeFileSync(gitignorePath, cleanedGi.replace(/\n*$/, "\n"), "utf8");
-    gi = cleanedGi;
-    console.log("[INIT] Removed legacy deuk-agent-rule .gitignore entries");
-  }
-
-  const hasIgnoreLine = hasExactGitignoreLine(gi, ignoreLine);
-  const hasMarkerLine = hasExactGitignoreLine(gi, GITIGNORE_AGENT_MARKER);
-  if ((!hasIgnoreLine || !hasMarkerLine) && !opts.shareTickets) {
-    const linesToAdd = [];
-    if (!hasMarkerLine) linesToAdd.push(GITIGNORE_AGENT_MARKER);
-    if (!hasIgnoreLine) linesToAdd.push(ignoreLine);
-    const block = "\n" + linesToAdd.join("\n") + "\n";
-    appendFileSync(gitignorePath, block, "utf8");
-    console.log(`[INIT] Added ${ignoreLine} to .gitignore`);
-  }
-}

package/scripts/cli-skill-commands.mjs

@@ -1,212 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "fs";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-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 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, SKILL_PATHS.installedRoot, id, "SKILL.md");
-}
-
-function sourceSkillPath(cwd, id) {
-  const repoTemplate = join(cwd, SKILL_PATHS.templateRoot, id, "SKILL.md");
-  if (existsSync(repoTemplate)) return repoTemplate;
-  return join(PACKAGE_ROOT, SKILL_ROOT, id, "SKILL.md");
-}
-
-function loadSkillSource(cwd, id) {
-  const source = sourceSkillPath(cwd, id);
-  if (!existsSync(source)) throw new Error(`skill not found: ${id}`);
-  return readFileSync(source, "utf8");
-}
-
-function loadSkillConfig(cwd) {
-  const path = join(cwd, CONFIG_FILE);
-  return safeReadJson(path, { version: 1, installed: [], exposed: {} });
-}
-
-function detectExposedPlatforms(cwd, id) {
-  const platforms = [];
-  const claudePath = join(cwd, SKILL_PATHS.claudeRoot, id, "SKILL.md");
-  if (existsSync(claudePath)) {
-    platforms.push("claude");
-  }
-
-  const cursorPath = join(cwd, SKILL_PATHS.cursorPointer);
-  if (existsSync(cursorPath)) {
-    try {
-      const body = readFileSync(cursorPath, "utf8");
-      if (body.includes(`.deuk-agent/skills/${id}/SKILL.md`)) {
-        platforms.push("cursor");
-      }
-    } catch {
-      // Ignore pointer read failures and fall back to config-based exposure only.
-    }
-  }
-
-  return platforms;
-}
-
-function writeSkillConfig(cwd, config, dryRun) {
-  if (dryRun) return;
-  const path = join(cwd, CONFIG_FILE);
-  mkdirSync(dirname(path), { recursive: true });
-  writeFileSync(path, JSON.stringify(config, null, 2), "utf8");
-}
-
-function ensureKnownSkill(id) {
-  if (!SKILL_IDS.includes(id)) throw new Error(`unknown skill: ${id}`);
-}
-
-export function listSkills(cwd = process.cwd()) {
-  const config = loadSkillConfig(cwd);
-  return SKILL_IDS.map(id => ({
-    id,
-    installed: config.installed.includes(id) || existsSync(repoSkillPath(cwd, id)),
-    exposed: Array.from(new Set([
-      ...Object.entries(config.exposed || {})
-      .filter(([, ids]) => Array.isArray(ids) && ids.includes(id))
-      .map(([platform]) => platform),
-      ...detectExposedPlatforms(cwd, id)
-    ]))
-  }));
-}
-
-export function addSkill(opts = {}) {
-  const cwd = opts.cwd || process.cwd();
-  const id = opts.skill;
-  ensureKnownSkill(id);
-  const body = loadSkillSource(cwd, id);
-  const target = repoSkillPath(cwd, id);
-  const config = loadSkillConfig(cwd);
-
-  if (!opts.dryRun) {
-    mkdirSync(dirname(target), { recursive: true });
-    writeFileSync(target, body, "utf8");
-  }
-
-  if (!config.installed.includes(id)) config.installed.push(id);
-  writeSkillConfig(cwd, config, opts.dryRun);
-  return { id, target };
-}
-
-function exposeClaude(cwd, ids, dryRun) {
-  for (const id of ids) {
-    const body = readFileSync(repoSkillPath(cwd, id), "utf8");
-    const target = join(cwd, SKILL_PATHS.claudeRoot, id, "SKILL.md");
-    if (!dryRun) {
-      mkdirSync(dirname(target), { recursive: true });
-      writeFileSync(target, body, "utf8");
-    }
-  }
-}
-
-function exposeCursor(cwd, ids, dryRun) {
-  const target = join(cwd, SKILL_PATHS.cursorPointer);
-  const body = [
-    "---",
-    "description: \"DeukAgentFlow skill pointers\"",
-    "globs: [\"**/*\"]",
-    "alwaysApply: false",
-    "---",
-    "# DeukAgentFlow Skills",
-    "",
-    "These are thin behavior playbooks. They do not override `core-rules/AGENTS.md`, TDW, APC, Phase Gate, or PROJECT_RULE.md.",
-    "",
-    ...ids.map(id => `- ${id}: .deuk-agent/skills/${id}/SKILL.md`),
-    ""
-  ].join("\n");
-  if (!dryRun) {
-    mkdirSync(dirname(target), { recursive: true });
-    writeFileSync(target, body, "utf8");
-  }
-}
-
-export function exposeSkills(opts = {}) {
-  const cwd = opts.cwd || process.cwd();
-  const platform = String(opts.platform || "").toLowerCase();
-  if (!["claude", "cursor"].includes(platform)) throw new Error("skill expose requires --platform claude|cursor");
-
-  const config = loadSkillConfig(cwd);
-  const ids = config.installed || [];
-  if (ids.length === 0) throw new Error("no skills installed; run skill add first");
-  for (const id of ids) {
-    if (!existsSync(repoSkillPath(cwd, id))) addSkill({ cwd, skill: id, dryRun: opts.dryRun });
-  }
-
-  if (platform === "claude") exposeClaude(cwd, ids, opts.dryRun);
-  if (platform === "cursor") exposeCursor(cwd, ids, opts.dryRun);
-
-  config.exposed = config.exposed || {};
-  config.exposed[platform] = Array.from(new Set([...(config.exposed[platform] || []), ...ids]));
-  writeSkillConfig(cwd, config, opts.dryRun);
-  return { platform, ids };
-}
-
-export function lintSkills(cwd = process.cwd()) {
-  const paths = [];
-  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");
-      if (existsSync(path)) paths.push(path);
-    }
-  }
-
-  const violations = [];
-  const forbidden = [/ignore ticket/i, /skip verification/i, /override (tdw|apc|phase gate)/i, /edit generated output directly/i];
-  for (const path of paths) {
-    const body = readFileSync(path, "utf8");
-    if (!/Authority:.*core-rules\/AGENTS\.md/i.test(body)) violations.push(`${path}: missing authority line`);
-    for (const pattern of forbidden) {
-      if (pattern.test(body)) violations.push(`${path}: forbidden phrase ${pattern}`);
-    }
-  }
-  return { ok: violations.length === 0, paths, violations };
-}
-
-export async function runSkill(action, opts = {}) {
-  if (action === "list") {
-    const rows = listSkills(opts.cwd);
-    if (opts.json) console.log(JSON.stringify(rows, null, 2));
-    else rows.forEach(row => console.log(`${row.id} installed=${row.installed ? "yes" : "no"} exposed=${row.exposed.join(",") || "-"}`));
-    return;
-  }
-  if (action === "add") {
-    const result = addSkill(opts);
-    console.log(`skill added: ${result.id}`);
-    return;
-  }
-  if (action === "expose") {
-    const result = exposeSkills(opts);
-    console.log(`skills exposed: ${result.platform} ${result.ids.join(",")}`);
-    return;
-  }
-  if (action === "lint") {
-    const result = lintSkills(opts.cwd);
-    if (opts.json) console.log(JSON.stringify(result, null, 2));
-    else console.log(result.ok ? "skill:lint ok" : `skill:lint failed ${result.violations.length}`);
-    if (!result.ok) throw new Error(result.violations.join("\n"));
-    return;
-  }
-  throw new Error("Unknown skill action: " + action);
-}

package/scripts/cli-ticket-command-shared.mjs

@@ -1,60 +0,0 @@
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-import { AGENT_ROOT_DIR, computeTicketPath, parseFrontMatter } from "./cli-utils.mjs";
-
-export const TICKET_REPORTS_SUBDIR = "plan";
-
-export function resolveTicketReportDir(cwd) {
-  return join(cwd, AGENT_ROOT_DIR, "docs", TICKET_REPORTS_SUBDIR);
-}
-
-export function resolveTicketPath(cwd, relPath) {
-  return join(cwd, String(relPath || ""));
-}
-
-export function resolveTicketEntryPath(cwd, entry) {
-  return resolveTicketPath(cwd, entry?.path || "");
-}
-
-export function resolveTicketEntryOrComputedPath(cwd, entry) {
-  return resolveTicketPath(cwd, entry?.path || computeTicketPath(entry));
-}
-
-export function resolveTicketKnowledgeDir(cwd) {
-  return join(cwd, AGENT_ROOT_DIR, "knowledge");
-}
-
-export function readTicketDocument(cwd, entry, options = {}) {
-  const shouldCompute = options.computePath || !entry?.path;
-  const absPath = shouldCompute
-    ? resolveTicketEntryOrComputedPath(cwd, entry)
-    : resolveTicketEntryPath(cwd, entry);
-
-  const parse = options.parse ?? true;
-  const requireExists = options.requireExists ?? true;
-  const action = options.action || "ticket";
-
-  const exists = existsSync(absPath);
-  if (!exists && requireExists) {
-    const target = entry?.path || "unknown";
-    throw new Error(`${action}: Ticket file not found: ${target}`);
-  }
-
-  if (!exists) {
-    return {
-      absPath,
-      exists: false,
-      body: "",
-      meta: {},
-      content: ""
-    };
-  }
-
-  const body = readFileSync(absPath, "utf8");
-  if (!parse) {
-    return { absPath, exists: true, body, meta: {}, content: "" };
-  }
-
-  const parsed = parseFrontMatter(body);
-  return { absPath, exists: true, body, ...parsed };
-}