aicoding-rules 0.1.0

package/README.md

@@ -0,0 +1,95 @@
+# aicoding-rules
+
+A CLI tool to download and install AI coding rules for various AI assistants.
+
+## Supported Tools
+
+- **Cursor** - IDE-specific rules for Cursor editor
+- **Claude** - Rules for Claude AI assistant
+- **Antigravity** - Antigravity platform rules
+- **Copilot** - GitHub Copilot prompts
+
+## Installation
+
+```bash
+npm install -g aicoding-rules
+```
+
+Or run directly with npx:
+
+```bash
+npx aicoding-rules
+```
+
+## Usage
+
+### Interactive Mode
+
+Run without arguments to select rules interactively:
+
+```bash
+npx aicoding-rules
+```
+
+You'll see a checkbox menu:
+
+```
+? Select rules to install: (Press <space> to select, <a> to toggle all)
+ ◯ Cursor rules
+ ◯ Claude rules
+ ◯ Antigravity rules
+ ◯ Copilot prompts
+```
+
+### Direct Commands
+
+Install specific rules directly:
+
+```bash
+npx aicoding-rules cursor
+npx aicoding-rules claude
+npx aicoding-rules antigravity
+npx aicoding-rules copilot
+```
+
+Install all rules at once:
+
+```bash
+npx aicoding-rules all
+```
+
+## Authentication
+
+The tool uses Plus4U OIDC authentication. On first run, a browser window will open for you to log in. The authentication token is cached for the session.
+
+## Configuration
+
+Create `~/.aicoding-rules.json` to override default settings:
+
+```json
+{
+  "documentOid": "your-document-oid",
+  "baseUrl": "https://your-custom-url.com",
+  "rules": {
+    "cursor": {
+      "fileOid": "custom-file-oid",
+      "name": "Custom Cursor Rules"
+    },
+    "custom-tool": {
+      "fileOid": "another-file-oid",
+      "name": "My Custom Tool"
+    }
+  }
+}
+```
+
+Custom rules defined in the config file will appear in the interactive menu.
+
+## Output
+
+Rules are extracted to the current working directory. Run the command from the root of your project.
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Plus4U account with access to the rules repository

package/bin/cli.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import { loadConfig, getRuleKeys } from "../src/config.js";
+import { downloadAndExtract, downloadMultiple } from "../src/download.js";
+import { selectRules } from "../src/interactive.js";
+
+const config = loadConfig();
+const targetDir = process.cwd();
+
+const program = new Command();
+
+program
+  .name("aicoding-rules")
+  .description("Download and install AI coding rules for Cursor, Claude, Antigravity, and Copilot")
+  .version("1.0.0");
+
+program
+  .command("cursor")
+  .description("Install Cursor rules")
+  .action(async () => {
+    await downloadAndExtract(config, "cursor", targetDir);
+  });
+
+program
+  .command("claude")
+  .description("Install Claude rules")
+  .action(async () => {
+    await downloadAndExtract(config, "claude", targetDir);
+  });
+
+program
+  .command("antigravity")
+  .description("Install Antigravity rules")
+  .action(async () => {
+    await downloadAndExtract(config, "antigravity", targetDir);
+  });
+
+program
+  .command("copilot")
+  .description("Install Copilot prompts")
+  .action(async () => {
+    await downloadAndExtract(config, "copilot", targetDir);
+  });
+
+program
+  .command("all")
+  .description("Install all rules")
+  .action(async () => {
+    const allKeys = getRuleKeys(config);
+    await downloadMultiple(config, allKeys, targetDir);
+  });
+
+program
+  .action(async () => {
+    const selectedKeys = await selectRules(config);
+    await downloadMultiple(config, selectedKeys, targetDir);
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "aicoding-rules",
+  "version": "0.1.0",
+  "description": "Download and install AI coding rules for Cursor, Claude, Antigravity, and Copilot",
+  "license": "MIT",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "aicoding-rules": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "uu_appg01_devkit-common": "^6.5.0",
+    "adm-zip": "^0.5.16",
+    "commander": "^12.0.0",
+    "inquirer": "^9.0.0"
+  }
+}

package/src/auth.js

@@ -0,0 +1,26 @@
+import { createRequire } from "module";
+
+const require = createRequire(import.meta.url);
+const OidcClient = require("uu_appg01_devkit-common/src/scripts/oidc-client");
+const AppClient = require("uu_appg01_devkit-common/src/scripts/misc/app-client");
+
+let cachedAppClient = null;
+
+export async function getAuthenticatedClient() {
+  if (cachedAppClient) {
+    return cachedAppClient;
+  }
+
+  console.log("Starting Plus4U authentication...");
+  
+  const token = await OidcClient.interactiveLogin();
+  
+  if (!token) {
+    throw new Error("Authentication failed - no token received");
+  }
+
+  cachedAppClient = new AppClient({ get: () => `Bearer ${token}` });
+  console.log("Authentication successful!\n");
+  
+  return cachedAppClient;
+}

package/src/config.js

@@ -0,0 +1,52 @@
+import { readFileSync, existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+
+const CONFIG_FILE = ".aicoding-rules.json";
+
+const DEFAULT_CONFIG = {
+  documentOid: "67eab558899a1711f6cbf55f",
+  baseUrl: "https://uuapp.plus4u.net/uu-managementkit-maing02/9d3f27636f2e439f98529b1e12231924",
+  rules: {
+    cursor: { fileOid: "67eab7b2899a1711f6cc1580", name: "Cursor rules" },
+    claude: { fileOid: "68872b563e3eb464f2214263", name: "Claude rules" },
+    antigravity: { fileOid: "69202dcfacf31067955cfc1c", name: "Antigravity rules" },
+    copilot: { fileOid: "67eab73e899a1711f6cc106f", name: "Copilot prompts" }
+  }
+};
+
+function deepMerge(target, source) {
+  const result = { ...target };
+  for (const key of Object.keys(source)) {
+    if (source[key] && typeof source[key] === "object" && !Array.isArray(source[key])) {
+      result[key] = deepMerge(target[key] || {}, source[key]);
+    } else {
+      result[key] = source[key];
+    }
+  }
+  return result;
+}
+
+export function loadConfig() {
+  const configPath = join(homedir(), CONFIG_FILE);
+  
+  if (!existsSync(configPath)) {
+    return DEFAULT_CONFIG;
+  }
+
+  try {
+    const userConfig = JSON.parse(readFileSync(configPath, "utf-8"));
+    return deepMerge(DEFAULT_CONFIG, userConfig);
+  } catch (error) {
+    console.warn(`Warning: Failed to parse ${configPath}, using defaults.`);
+    return DEFAULT_CONFIG;
+  }
+}
+
+export function getRuleKeys(config) {
+  return Object.keys(config.rules);
+}
+
+export function getRule(config, key) {
+  return config.rules[key];
+}

package/src/download.js

@@ -0,0 +1,40 @@
+import AdmZip from "adm-zip";
+import { getAuthenticatedClient } from "./auth.js";
+
+function extractZipBuffer(buffer, outputPath) {
+  const zip = new AdmZip(buffer);
+  zip.extractAllTo(outputPath, true);
+}
+
+export async function downloadAndExtract(config, ruleKey, targetDir) {
+  const rule = config.rules[ruleKey];
+  if (!rule) {
+    throw new Error(`Unknown rule: ${ruleKey}`);
+  }
+
+  const appClient = await getAuthenticatedClient();
+  
+  const url = `${config.baseUrl}/document/ebc/file/getDataByOid?oid=${config.documentOid}&uuEbcData.fileOid=${rule.fileOid}`;
+  
+  console.log(`Downloading ${rule.name}...`);
+  
+  const response = await appClient.exchange(
+    url,
+    "get",
+    {},
+    {},
+    0,
+    { responseType: "buffer" }
+  );
+
+  const attachmentBuffer = response.body;
+  extractZipBuffer(attachmentBuffer, targetDir);
+  
+  console.log(`${rule.name} installed to ${targetDir}`);
+}
+
+export async function downloadMultiple(config, ruleKeys, targetDir) {
+  for (const key of ruleKeys) {
+    await downloadAndExtract(config, key, targetDir);
+  }
+}

package/src/interactive.js

@@ -0,0 +1,28 @@
+import inquirer from "inquirer";
+import { getRuleKeys, getRule } from "./config.js";
+
+export async function selectRules(config) {
+  const ruleKeys = getRuleKeys(config);
+  
+  const choices = ruleKeys.map(key => ({
+    name: getRule(config, key).name,
+    value: key
+  }));
+
+  const { selectedRules } = await inquirer.prompt([
+    {
+      type: "checkbox",
+      name: "selectedRules",
+      message: "Select rules to install:",
+      choices,
+      validate: (answer) => {
+        if (answer.length === 0) {
+          return "You must select at least one rule.";
+        }
+        return true;
+      }
+    }
+  ]);
+
+  return selectedRules;
+}