@db-ux/agent-cli 3.0.2-copilot-66b0168

package/README.md

@@ -0,0 +1,47 @@
+# @db-ux/agent-cli
+
+![Apache 2.0 license badge](https://img.shields.io/badge/License-Apache_2.0-blue.svg)
+[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
+[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://makeapullrequest.com)
+
+## Usage
+
+We provide a cli tool to copy `@db-ux` docs to your repository to provide it for AI Agents.
+Use this command in your repository:
+
+```shell
+npx @db-ux/agent-cli
+```
+
+This will search for all `@db-ux` packages inside your `node_modules` and copy the documentation to your repository.
+A new folder will be created named `_db-ux-docs`.
+
+You might want to add this folder to your `.gitignore` file.
+
+You can also change the root path where the tool should check for `node_modules`:
+
+```shell
+npx @db-ux/agent-cli packages/frontend
+```
+
+## Deutsche Bahn brand
+
+As we'd like to perfectly support our users and customers on their digital journey, the usage of Deutsche Bahn brand and trademarks are bound of clear guidelines and restrictions even if being used with the code that we're providing with this product; Deutsche Bahn fully reserves all rights regarding the Deutsche Bahn brand, even though that we're providing the code of DB UX Design System products free to use and release it under the Apache 2.0 license.
+Please have a look at our brand portal at <https://marketingportal.extranet.deutschebahn.com/> for any further questions and whom to contact on any brand issues.
+
+For any usage outside of Deutsche Bahn websites and applications you aren't allowed to use any Deutsche Bahn brand and
+design assets as well as protected characteristics and trademarks, that for not including the DB Theme.
+
+## Contributions
+
+Contributions are very welcome, please refer to the [contribution guide](https://github.com/db-ux-design-system/core-web/blob/main/CONTRIBUTING.md).
+
+## Code of conduct
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone – have a look at our [Contributor Covenant Code of Conduct](https://github.com/db-ux-design-system/core-web/blob/main/CODE-OF-CONDUCT.md).
+
+## License
+
+This project is licensed under [Apache-2.0](LICENSE).

package/build/index.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { program } from "commander";
+
+// src/copilot/index.ts
+import fs from "fs";
+import path from "path";
+function findAllNodeModulesDirs(dir, found = []) {
+  if (!fs.existsSync(dir)) return found;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules") {
+        found.push(path.join(dir, entry.name));
+      } else if (!entry.name.startsWith(".")) {
+        findAllNodeModulesDirs(path.join(dir, entry.name), found);
+      }
+    }
+  }
+  return found;
+}
+var generateCopilot = (rootPath) => {
+  const outputFolder = path.resolve(rootPath, ".github");
+  const nodeModulesDirs = findAllNodeModulesDirs(rootPath);
+  if (nodeModulesDirs.length === 0) {
+    console.error("No node_modules folders found.");
+    return;
+  }
+  let copilotInstructionsContent = "";
+  for (const nodeModulesPath of nodeModulesDirs) {
+    const dbUxPath = path.join(nodeModulesPath, "@db-ux");
+    if (!fs.existsSync(dbUxPath)) {
+      continue;
+    }
+    const packages = fs.readdirSync(dbUxPath, { withFileTypes: true });
+    for (const pkg of packages) {
+      if (pkg.isDirectory()) {
+        const instructionsPath = path.join(
+          dbUxPath,
+          pkg.name,
+          "agent",
+          "_instructions.md"
+        );
+        if (fs.existsSync(instructionsPath)) {
+          let content = fs.readFileSync(instructionsPath, "utf-8");
+          const relPath = path.relative(
+            rootPath,
+            path.join(dbUxPath, pkg.name)
+          );
+          content = content.replace(
+            /__agent-path__/g,
+            relPath.replace(/\\/g, "/")
+          );
+          copilotInstructionsContent += `
+# @db-ux/${pkg.name}
+${content}
+`;
+        }
+      }
+    }
+  }
+  if (!fs.existsSync(outputFolder)) {
+    fs.mkdirSync(outputFolder);
+  }
+  const copilotInstructionsPath = path.join(
+    outputFolder,
+    "copilot-instructions.md"
+  );
+  if (!fs.existsSync(copilotInstructionsPath)) {
+    fs.writeFileSync(copilotInstructionsPath, "");
+  }
+  if (copilotInstructionsContent.trim()) {
+    let copilotFileContent = fs.readFileSync(
+      copilotInstructionsPath,
+      "utf-8"
+    );
+    const startMarker = "--- START: DB UX Copilot Instructions ---";
+    const endMarker = "--- END: DB UX Copilot Instructions ---";
+    const startIdx = copilotFileContent.indexOf(startMarker);
+    const endIdx = copilotFileContent.indexOf(endMarker);
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+      copilotFileContent = (copilotFileContent.slice(0, startIdx) + copilotFileContent.slice(endIdx + endMarker.length)).trim();
+    }
+    copilotFileContent += `
+${startMarker}
+${copilotInstructionsContent}
+${endMarker}
+`;
+    fs.writeFileSync(copilotInstructionsPath, copilotFileContent);
+  }
+};
+
+// src/cli.ts
+var action = async (rootPath = ".") => {
+  generateCopilot(rootPath);
+};
+var startProgram = (name, description, action2) => {
+  program.name(name).description(description);
+  program.argument(
+    "[root]",
+    "Root path to generate AI agent instructions. Default: `.`"
+  );
+  program.action(action2);
+  program.parse();
+};
+startProgram(
+  "@db-ux/agent-cli",
+  "CLI for DB UX Design System generate AI agent instructions",
+  action
+);

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@db-ux/agent-cli",
+  "version": "3.0.2-copilot-66b0168",
+  "type": "module",
+  "description": "CLI for DB UX Design System generate AI agent instructions",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/db-ux-design-system/core-web.git"
+  },
+  "license": "Apache-2.0",
+  "bin": {
+    "@db-uxagent-cli": "build/index.js"
+  },
+  "main": "build.js",
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "build": "node esbuild.js",
+    "copy-build": "npm-run-all copy-build:*",
+    "copy-build:build": "cpr build ../../build-outputs/agent-cli/build -o",
+    "copy-build:package.json": "cpr package.json ../../build-outputs/agent-cli/package.json -o",
+    "copy-build:readme": "cpr README.md ../../build-outputs/agent-cli/README.md -o",
+    "test": "vitest run --config vitest.config.ts",
+    "test:cli": "tsx src/cli.ts --help"
+  },
+  "dependencies": {
+    "commander": "^14.0.0",
+    "glob": "^11.0.2"
+  },
+  "devDependencies": {
+    "cpr": "3.0.1",
+    "esbuild": "0.25.5",
+    "tsx": "^4.19.4",
+    "vitest": "^3.2.1"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  }
+}