fielmann-devkit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fielmann AG
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# fielmann-devkit
+
+Interactive CLI to set up the [Fielmann AI DevKit](https://github.com/fielmann-ag/ai-devkit) in your project with a single command.
+
+## Usage
+
+```bash
+npx fielmann-devkit
+```
+
+The wizard will:
+
+1. Confirm you are in your project's root directory
+2. Verify you have access to the AI DevKit repository
+3. Add the AI DevKit as a Git submodule (`.ai-devkit/`)
+4. Run the setup script to copy Cursor rules, commands, and MCP configuration into your `.cursor/` directory
+
+## Prerequisites
+
+- **Node.js** >= 18
+- **Git** installed and available on your PATH
+- **GitHub access** to [fielmann-ag/ai-devkit](https://github.com/fielmann-ag/ai-devkit) (request access from adam.zdrzalka@fielmann.com if needed)
+
+## What gets set up
+
+After running the wizard, your project will have:
+
+```
+your-project/
+├── .ai-devkit/                  # Git submodule (AI DevKit source)
+├── .cursor/
+│   ├── rules/general-use/       # Cursor rules from AI DevKit
+│   ├── rules/project-specific/  # Your own project rules (untouched)
+│   ├── commands/general-use/    # Commands from AI DevKit
+│   ├── commands/project-specific/ # Your own project commands (untouched)
+│   └── mcp.json                 # MCP server configuration (if not already present)
+└── [your project files]
+```
+
+## Updating the AI DevKit
+
+To pull the latest updates after initial setup:
+
+```bash
+cd .ai-devkit
+./ai-devkit-update.sh
+```
+
+## License
+
+MIT

package/dist/bin/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { runWizard } from "../src/index.js";
+try {
+    await runWizard();
+}
+catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\n${message}`);
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,IAAI,CAAC;IACH,MAAM,SAAS,EAAE,CAAC;AACpB,CAAC;AAAC,OAAO,KAAc,EAAE,CAAC;IACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1 @@
+export declare function runWizard(): Promise<void>;

package/dist/src/index.js

@@ -0,0 +1,15 @@
+import chalk from "chalk";
+import { checkProjectRoot } from "./steps/checkProjectRoot.js";
+import { checkRepoAccess } from "./steps/checkRepoAccess.js";
+import { addSubmodule } from "./steps/addSubmodule.js";
+import { runSetup } from "./steps/runSetup.js";
+export async function runWizard() {
+    console.log(chalk.bold.blue("\n  Fielmann AI DevKit Setup\n"));
+    await checkProjectRoot();
+    await checkRepoAccess();
+    await addSubmodule();
+    await runSetup();
+    console.log(chalk.bold.green("\nAll done! The AI DevKit is set up in your project."));
+    console.log(chalk.blue("Your Cursor rules, commands, and MCP config are ready.\n"));
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAClD,CAAC;IAEF,MAAM,gBAAgB,EAAE,CAAC;IACzB,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,YAAY,EAAE,CAAC;IACrB,MAAM,QAAQ,EAAE,CAAC;IAEjB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,KAAK,CACd,sDAAsD,CACvD,CACF,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/src/steps/addSubmodule.d.ts

@@ -0,0 +1 @@
+export declare function addSubmodule(): Promise<void>;

package/dist/src/steps/addSubmodule.js

@@ -0,0 +1,35 @@
+import { existsSync } from "node:fs";
+import chalk from "chalk";
+import ora from "ora";
+import { execa } from "execa";
+const REPO_URL = "https://github.com/fielmann-ag/ai-devkit.git";
+const SUBMODULE_DIR = ".ai-devkit";
+export async function addSubmodule() {
+    if (existsSync(SUBMODULE_DIR)) {
+        console.log(chalk.blue(`\n${SUBMODULE_DIR}/ already exists — skipping submodule add.`));
+        return;
+    }
+    const spinner = ora("Adding AI DevKit as a Git submodule…").start();
+    try {
+        await execa("git", ["submodule", "add", REPO_URL, SUBMODULE_DIR]);
+        spinner.succeed("AI DevKit submodule added successfully.");
+    }
+    catch (err) {
+        spinner.fail("Failed to add the AI DevKit submodule.");
+        const error = err;
+        if (error.stderr?.includes("not a git repository")) {
+            console.log(chalk.red("\nThis directory is not a Git repository. Initialize one first with:"));
+            console.log(chalk.cyan("  git init\n"));
+        }
+        else if (error.stderr?.includes("Authentication failed") ||
+            error.stderr?.includes("could not read Username")) {
+            console.log(chalk.red("\nAuthentication failed. Make sure you have access to the repo and that"));
+            console.log(chalk.red("your Git credentials (SSH key or personal access token) are configured.\n"));
+        }
+        else {
+            console.log(chalk.red(`\n${error.stderr || error.message}\n`));
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=addSubmodule.js.map

package/dist/src/steps/addSubmodule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addSubmodule.js","sourceRoot":"","sources":["../../../src/steps/addSubmodule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,MAAM,QAAQ,GAAG,8CAA8C,CAAC;AAChE,MAAM,aAAa,GAAG,YAAY,CAAC;AAEnC,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,IAAI,CAAC,KAAK,aAAa,4CAA4C,CAAC,CAC3E,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,sCAAsC,CAAC,CAAC,KAAK,EAAE,CAAC;IAEpE,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QAEvD,MAAM,KAAK,GAAG,GAA4C,CAAC;QAE3D,IAAI,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CACP,sEAAsE,CACvE,CACF,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;QAC1C,CAAC;aAAM,IACL,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC;YAC/C,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,yBAAyB,CAAC,EACjD,CAAC;YACD,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CACP,yEAAyE,CAC1E,CACF,CAAC;YACF,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CACP,2EAA2E,CAC5E,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/src/steps/checkProjectRoot.d.ts

@@ -0,0 +1 @@
+export declare function checkProjectRoot(): Promise<void>;

package/dist/src/steps/checkProjectRoot.js

@@ -0,0 +1,14 @@
+import { confirm } from "@inquirer/prompts";
+import chalk from "chalk";
+export async function checkProjectRoot() {
+    const isRoot = await confirm({
+        message: "Are you in your project's root directory?",
+        default: true,
+    });
+    if (!isRoot) {
+        console.log(chalk.yellow("\nPlease navigate to your project's root directory and rerun:"));
+        console.log(chalk.cyan("  npx fielmann-devkit\n"));
+        process.exit(0);
+    }
+}
+//# sourceMappingURL=checkProjectRoot.js.map

package/dist/src/steps/checkProjectRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkProjectRoot.js","sourceRoot":"","sources":["../../../src/steps/checkProjectRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;QAC3B,OAAO,EAAE,2CAA2C;QACpD,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CACV,+DAA+D,CAChE,CACF,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/src/steps/checkRepoAccess.d.ts

@@ -0,0 +1 @@
+export declare function checkRepoAccess(): Promise<void>;

package/dist/src/steps/checkRepoAccess.js

@@ -0,0 +1,16 @@
+import { confirm } from "@inquirer/prompts";
+import chalk from "chalk";
+const REPO_URL = "https://github.com/fielmann-ag/ai-devkit";
+export async function checkRepoAccess() {
+    const hasAccess = await confirm({
+        message: `Do you have access to the AI DevKit repo? (${REPO_URL})`,
+        default: true,
+    });
+    if (!hasAccess) {
+        console.log(chalk.yellow("\nYou need access to the AI DevKit repository to continue."));
+        console.log(chalk.yellow("Request access by contacting:"));
+        console.log(chalk.cyan("  Adam Zdrzalka — adam.zdrzalka@fielmann.com\n"));
+        process.exit(0);
+    }
+}
+//# sourceMappingURL=checkRepoAccess.js.map

package/dist/src/steps/checkRepoAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkRepoAccess.js","sourceRoot":"","sources":["../../../src/steps/checkRepoAccess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,QAAQ,GAAG,0CAA0C,CAAC;AAE5D,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC;QAC9B,OAAO,EAAE,8CAA8C,QAAQ,GAAG;QAClE,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CAAC,4DAA4D,CAAC,CAC3E,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,+BAA+B,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/src/steps/runSetup.d.ts

@@ -0,0 +1 @@
+export declare function runSetup(): Promise<void>;

package/dist/src/steps/runSetup.js

@@ -0,0 +1,30 @@
+import { existsSync } from "node:fs";
+import { chmod } from "node:fs/promises";
+import { join } from "node:path";
+import chalk from "chalk";
+import { execa } from "execa";
+const SUBMODULE_DIR = ".ai-devkit";
+const SETUP_SCRIPT = "ai-devkit-setup.sh";
+export async function runSetup() {
+    const scriptPath = join(SUBMODULE_DIR, SETUP_SCRIPT);
+    if (!existsSync(scriptPath)) {
+        console.log(chalk.red(`\nSetup script not found at ${scriptPath}.`));
+        console.log(chalk.yellow("Try updating the submodule: git submodule update --remote .ai-devkit\n"));
+        process.exit(1);
+    }
+    await chmod(scriptPath, 0o755);
+    console.log(chalk.blue("\nRunning AI DevKit setup script…\n"));
+    try {
+        await execa(`./${SETUP_SCRIPT}`, {
+            cwd: SUBMODULE_DIR,
+            stdout: "inherit",
+            stderr: "inherit",
+        });
+    }
+    catch {
+        console.log(chalk.red("\nThe setup script failed. You can retry manually with:"));
+        console.log(chalk.cyan(`  cd ${SUBMODULE_DIR} && ./${SETUP_SCRIPT}\n`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=runSetup.js.map

package/dist/src/steps/runSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runSetup.js","sourceRoot":"","sources":["../../../src/steps/runSetup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,MAAM,aAAa,GAAG,YAAY,CAAC;AACnC,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAErD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CAAC,+BAA+B,UAAU,GAAG,CAAC,CACxD,CAAC;QACF,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CACV,wEAAwE,CACzE,CACF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAE/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC,CAAC;IAE/D,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,KAAK,YAAY,EAAE,EAAE;YAC/B,GAAG,EAAE,aAAa;YAClB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CAAC,yDAAyD,CAAC,CACrE,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,aAAa,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "fielmann-devkit",
+  "version": "1.0.0",
+  "description": "CLI to set up the Fielmann AI DevKit in your project",
+  "bin": {
+    "fielmann-devkit": "./dist/bin/cli.js"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "fielmann",
+    "ai",
+    "devkit",
+    "cursor",
+    "development",
+    "cli"
+  ],
+  "author": "Adam Zdrzalka <adam.zdrzalka@fielmann.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fielmann-ag/fielmann-devkit-npm-pkg.git"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.3.0",
+    "chalk": "^5.4.1",
+    "execa": "^9.5.2",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.1",
+    "typescript": "^5.9.3"
+  }
+}