agent-rules/dist/main.cjs

Rules and instructions for agentic coding tools like Cursor, Claude CLI, Gemini CLI, Qodo, Cline and more

"use strict";
var __create = Object.create;
var __defProp = Object.defineProperty;
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
var __getOwnPropNames = Object.getOwnPropertyNames;
var __getProtoOf = Object.getPrototypeOf;
var __hasOwnProp = Object.prototype.hasOwnProperty;
var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
var __export = (target, all) => {
  for (var name in all)
    __defProp(target, name, { get: all[name], enumerable: true });
};
var __copyProps = (to, from, except, desc) => {
  if (from && typeof from === "object" || typeof from === "function") {
    for (let key of __getOwnPropNames(from))
      if (!__hasOwnProp.call(to, key) && key !== except)
        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
  }
  return to;
};
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
  // If the importer is in node compatibility mode or this is not an ESM
  // file that has been converted to a CommonJS file using a Babel-
  // compatible transform (i.e. "__esModule" has not been set), then set
  // "default" to the CommonJS "module.exports" for node compatibility.
  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
  mod
));
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);

// src/main.ts
var main_exports = {};
__export(main_exports, {
  getAiAppDirectory: () => getAiAppDirectory,
  resolveTemplateDirectory: () => resolveTemplateDirectory,
  scaffoldAiAppInstructions: () => scaffoldAiAppInstructions
});
module.exports = __toCommonJS(main_exports);
var import_node_path = __toESM(require("path"), 1);
var import_promises = __toESM(require("fs/promises"), 1);
var import_node_url = require("url");
var import_node_util = require("util");
var import_meta = {};
var debug = (0, import_node_util.debuglog)("agent-rules");
var templateRoot = "__template__";
var mapAiAppsToDirectories = {
  "github-copilot": {
    directory: ".github/instructions",
    filesSuffix: ".instructions.md"
  }
};
function resolvePackageRootDirectoryForTemplates() {
  let guessedDirName = "";
  try {
    if (typeof import_meta !== "undefined" && import_meta.url) {
      const __filename = (0, import_node_url.fileURLToPath)(import_meta.url);
      guessedDirName = import_node_path.default.dirname(__filename);
    } else {
      guessedDirName = __dirname;
    }
  } catch (error) {
    guessedDirName = __dirname;
  }
  if (guessedDirName.endsWith("src")) {
    return import_node_path.default.resolve(guessedDirName, "..");
  } else if (guessedDirName.endsWith("dist/bin") || guessedDirName.endsWith("dist\\bin")) {
    return import_node_path.default.resolve(guessedDirName, "..");
  } else {
    return guessedDirName;
  }
}
__name(resolvePackageRootDirectoryForTemplates, "resolvePackageRootDirectoryForTemplates");
function getAiAppDirectory(aiApp) {
  const app = Object.hasOwn(mapAiAppsToDirectories, aiApp) ? mapAiAppsToDirectories[aiApp] : null;
  if (!app) {
    throw new Error(`AI App "${aiApp}" is not supported.`);
  }
  return app;
}
__name(getAiAppDirectory, "getAiAppDirectory");
async function resolveTemplateDirectory(scaffoldInstructions) {
  const { codeLanguage, codeTopic } = scaffoldInstructions;
  const currentFileDirectory = resolvePackageRootDirectoryForTemplates();
  const templateDirectory = import_node_path.default.join(currentFileDirectory, templateRoot, codeLanguage, codeTopic);
  const resolvedTemplateDirectory = import_node_path.default.resolve(templateDirectory);
  try {
    const templateStats = await import_promises.default.stat(resolvedTemplateDirectory);
    if (!templateStats.isDirectory()) {
      throw new Error(`Template directory is not a directory: ${resolvedTemplateDirectory}`);
    }
  } catch (error) {
    throw new Error(`Template directory not found: ${resolvedTemplateDirectory}`);
  }
  return resolvedTemplateDirectory;
}
__name(resolveTemplateDirectory, "resolveTemplateDirectory");
async function createTargetDirectory(directory) {
  const resolvedTargetDirectory = import_node_path.default.resolve(directory);
  await import_promises.default.mkdir(resolvedTargetDirectory, { recursive: true });
  return resolvedTargetDirectory;
}
__name(createTargetDirectory, "createTargetDirectory");
function generateTargetFileName(templateFileName, filesSuffix) {
  const parsedFile = import_node_path.default.parse(templateFileName);
  let baseName = parsedFile.name;
  if (baseName.endsWith(".instructions")) {
    baseName = baseName.replace(/\.instructions$/, "");
  }
  return `${baseName}${filesSuffix}`;
}
__name(generateTargetFileName, "generateTargetFileName");
function validateTargetPath(targetFilePath, resolvedTargetDirectory) {
  const resolvedTargetFilePath = import_node_path.default.resolve(targetFilePath);
  if (!resolvedTargetFilePath.startsWith(resolvedTargetDirectory)) {
    throw new Error(`Invalid target path: ${targetFilePath}`);
  }
  return resolvedTargetFilePath;
}
__name(validateTargetPath, "validateTargetPath");
async function copyTemplateFile(templateFilePath, targetFilePath, resolvedTargetDirectory, filesSuffix) {
  const sanitizedTemplateFile = import_node_path.default.basename(templateFilePath);
  const fullTemplatePath = import_node_path.default.join(import_node_path.default.dirname(templateFilePath), sanitizedTemplateFile);
  debug("Processing template file:", sanitizedTemplateFile);
  try {
    const stat = await import_promises.default.stat(fullTemplatePath);
    if (stat.isFile()) {
      const targetFileName = generateTargetFileName(sanitizedTemplateFile, filesSuffix);
      const targetPath = import_node_path.default.join(targetFilePath, targetFileName);
      const resolvedTargetFilePath = validateTargetPath(targetPath, resolvedTargetDirectory);
      debug("Writing template file to target path:", resolvedTargetFilePath);
      const templateContent = await import_promises.default.readFile(fullTemplatePath, "utf-8");
      await import_promises.default.writeFile(resolvedTargetFilePath, templateContent, "utf-8");
    }
  } catch (error) {
    console.warn(`Skipping file ${sanitizedTemplateFile}: ${error instanceof Error ? error.message : "Unknown error"}`);
  }
}
__name(copyTemplateFile, "copyTemplateFile");
async function copyTemplateFiles(resolvedTemplateDirectory, resolvedTargetDirectory, filesSuffix) {
  const templateFiles = await import_promises.default.readdir(resolvedTemplateDirectory);
  for (const templateFile of templateFiles) {
    const templateFilePath = import_node_path.default.join(resolvedTemplateDirectory, templateFile);
    await copyTemplateFile(templateFilePath, resolvedTargetDirectory, resolvedTargetDirectory, filesSuffix);
  }
}
__name(copyTemplateFiles, "copyTemplateFiles");
async function scaffoldAiAppInstructions(scaffoldInstructions) {
  const { aiApp, codeLanguage, codeTopic } = scaffoldInstructions;
  if (!aiApp || !codeLanguage || !codeTopic) {
    throw new Error("Scaffold instructions must include aiApp and all other template choices.");
  }
  const aiAppConfig = getAiAppDirectory(aiApp);
  const { directory, filesSuffix } = aiAppConfig;
  debug(`Scaffolding AI App instructions in directory: ${directory} with files suffix: ${filesSuffix}`);
  const resolvedTemplateDirectory = await resolveTemplateDirectory(scaffoldInstructions);
  const resolvedTargetDirectory = await createTargetDirectory(directory);
  await copyTemplateFiles(resolvedTemplateDirectory, resolvedTargetDirectory, filesSuffix);
}
__name(scaffoldAiAppInstructions, "scaffoldAiAppInstructions");
// Annotate the CommonJS export names for ESM import in node:
0 && (module.exports = {
  getAiAppDirectory,
  resolveTemplateDirectory,
  scaffoldAiAppInstructions
});