clygl 1.0.0

package/README.md

@@ -0,0 +1,40 @@
+# clygl
+
+Modular CLI dev tool with plugins.
+
+## Install (Homebrew)
+
+```bash
+brew tap Charlilyyyy/clygl
+brew install clygl
+```
+
+Requires [`clygl` on npm](https://www.npmjs.com/package/clygl) — see [PUBLISH.md](./PUBLISH.md) for first-time release steps.
+
+## Quick start
+
+```bash
+clygl --help
+clygl gitleaks savepath src
+clygl gitleaks scan
+clygl install generate
+clygl generate list
+```
+
+## Optional plugins
+
+```bash
+clygl install generate
+clygl install hello
+```
+
+## Development
+
+See [guide.md](./guide.md).
+
+## Repos
+
+| GitHub repo | Purpose |
+|-------------|---------|
+| [Charlilyyyy/clygl](https://github.com/Charlilyyyy/clygl) | Source code (this project) |
+| [Charlilyyyy/homebrew-clygl](https://github.com/Charlilyyyy/homebrew-clygl) | Homebrew tap (`brew tap Charlilyyyy/clygl`) |

package/bundled-plugins/plugin-gitleaks/dist/config.d.ts

@@ -0,0 +1,4 @@
+export declare function getSavedScanPath(): string | undefined;
+export declare function setSavedScanPath(scanPath: string): void;
+export declare function clearSavedScanPath(): void;
+export declare function getConfigPath(): string;

package/bundled-plugins/plugin-gitleaks/dist/config.js

@@ -0,0 +1,37 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const CLYGL_HOME = join(homedir(), ".clygl");
+const CONFIG_PATH = join(CLYGL_HOME, "gitleaks.json");
+function ensureClyglHome() {
+    if (!existsSync(CLYGL_HOME)) {
+        mkdirSync(CLYGL_HOME, { recursive: true });
+    }
+}
+function readConfig() {
+    ensureClyglHome();
+    if (!existsSync(CONFIG_PATH)) {
+        return {};
+    }
+    return JSON.parse(readFileSync(CONFIG_PATH, "utf8"));
+}
+function writeConfig(config) {
+    ensureClyglHome();
+    writeFileSync(CONFIG_PATH, `${JSON.stringify(config, null, 2)}\n`);
+}
+export function getSavedScanPath() {
+    return readConfig().scanPath;
+}
+export function setSavedScanPath(scanPath) {
+    const config = readConfig();
+    config.scanPath = scanPath;
+    writeConfig(config);
+}
+export function clearSavedScanPath() {
+    const config = readConfig();
+    delete config.scanPath;
+    writeConfig(config);
+}
+export function getConfigPath() {
+    return CONFIG_PATH;
+}

package/bundled-plugins/plugin-gitleaks/dist/index.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function register(program: Command): void;

package/bundled-plugins/plugin-gitleaks/dist/index.js

@@ -0,0 +1,77 @@
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { clearSavedScanPath, getConfigPath, getSavedScanPath, setSavedScanPath, } from "./config.js";
+import { scanDirectory } from "./scan.js";
+function resolveScanRoot(cliPath) {
+    const pathToUse = cliPath ?? getSavedScanPath() ?? ".";
+    return resolve(process.cwd(), pathToUse);
+}
+export function register(program) {
+    const gitleaks = program
+        .command("gitleaks")
+        .description("Scan for secrets and common leak patterns in code");
+    gitleaks
+        .command("savepath")
+        .description("Save default scan directory for scan/report")
+        .argument("<path>", "Directory path (e.g. src)")
+        .action((scanPath) => {
+        setSavedScanPath(scanPath);
+        console.log(`Saved gitleaks scan path: ${scanPath}`);
+        console.log(`Config: ${getConfigPath()}`);
+        console.log("Run `clygl gitleaks scan` to use it.");
+    });
+    gitleaks
+        .command("showpath")
+        .description("Show saved scan directory")
+        .action(() => {
+        const saved = getSavedScanPath();
+        if (!saved) {
+            console.log("No saved path. Using current directory (.) when you run scan.");
+            console.log("Set one with: clygl gitleaks savepath src");
+            return;
+        }
+        console.log(`Saved scan path: ${saved}`);
+        console.log(`Resolved from cwd: ${resolve(process.cwd(), saved)}`);
+        console.log(`Config: ${getConfigPath()}`);
+    });
+    gitleaks
+        .command("clearpath")
+        .description("Remove saved scan directory")
+        .action(() => {
+        clearSavedScanPath();
+        console.log("Cleared saved scan path. scan/report will use . or an explicit path.");
+    });
+    gitleaks
+        .command("scan")
+        .description("Scan a directory for potential leaks")
+        .argument("[path]", "Directory to scan (uses savepath default if omitted)")
+        .action(async (scanPath) => {
+        const root = resolveScanRoot(scanPath);
+        const findings = await scanDirectory(root);
+        if (findings.length === 0) {
+            console.log(`No issues found in ${root}`);
+            return;
+        }
+        console.log(`Found ${findings.length} issue(s) in ${root}:`);
+        for (const finding of findings) {
+            console.log(`- ${finding.file}:${finding.line} [${finding.rule}] ${finding.snippet}`);
+        }
+    });
+    gitleaks
+        .command("report")
+        .description("Scan and write a JSON report")
+        .argument("[path]", "Directory to scan (uses savepath default if omitted)")
+        .option("-o, --output <file>", "Report file path", "gitleaks-report.json")
+        .action(async (scanPath, options) => {
+        const root = resolveScanRoot(scanPath);
+        const findings = await scanDirectory(root);
+        const report = {
+            scannedAt: new Date().toISOString(),
+            root,
+            count: findings.length,
+            findings,
+        };
+        await writeFile(options.output, `${JSON.stringify(report, null, 2)}\n`);
+        console.log(`Wrote ${findings.length} finding(s) to ${options.output}`);
+    });
+}

package/bundled-plugins/plugin-gitleaks/dist/scan.d.ts

@@ -0,0 +1,7 @@
+export type LeakFinding = {
+    file: string;
+    line: number;
+    rule: string;
+    snippet: string;
+};
+export declare function scanDirectory(rootPath: string): Promise<LeakFinding[]>;

package/bundled-plugins/plugin-gitleaks/dist/scan.js

@@ -0,0 +1,76 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+const SCAN_EXTENSIONS = new Set([
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".json",
+    ".env",
+    ".yaml",
+    ".yml",
+]);
+const RULES = [
+    {
+        rule: "hardcoded-secret",
+        pattern: /(?:api[_-]?key|secret|password|token|private[_-]?key)\s*[:=]\s*['"][^'"]{8,}['"]/i,
+    },
+    {
+        rule: "aws-access-key",
+        pattern: /AKIA[0-9A-Z]{16}/,
+    },
+    {
+        rule: "private-key-block",
+        pattern: /-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----/,
+    },
+    {
+        rule: "console-log",
+        pattern: /console\.(log|debug|info)\(/,
+    },
+];
+async function walkFiles(dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        if (entry.name.startsWith(".") || entry.name === "node_modules") {
+            continue;
+        }
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await walkFiles(fullPath)));
+            continue;
+        }
+        const ext = entry.name.includes(".")
+            ? entry.name.slice(entry.name.lastIndexOf("."))
+            : "";
+        if (SCAN_EXTENSIONS.has(ext)) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+export async function scanDirectory(rootPath) {
+    const files = await walkFiles(rootPath);
+    const findings = [];
+    for (const filePath of files) {
+        const content = await readFile(filePath, "utf8");
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (!line)
+                continue;
+            for (const { rule, pattern } of RULES) {
+                if (!pattern.test(line))
+                    continue;
+                findings.push({
+                    file: relative(rootPath, filePath) || filePath,
+                    line: i + 1,
+                    rule,
+                    snippet: line.trim().slice(0, 120),
+                });
+                break;
+            }
+        }
+    }
+    return findings;
+}

package/bundled-plugins/plugin-gitleaks/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@clygl/plugin-gitleaks",
+  "version": "1.0.0",
+  "description": "Scan code for secrets and sensitive patterns",
+  "type": "module",
+  "main": "dist/index.js",
+  "clyglPlugin": true,
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "commander": "^15.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "commander": "^15.0.0",
+    "typescript": "^6.0.3"
+  }
+}

package/dist/commands/generate.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerGenerateCommand(program: Command): void;
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QA2BvD"}

package/dist/commands/generate.js

@@ -0,0 +1,24 @@
+import { Command } from "commander";
+export function registerGenerateCommand(program) {
+    const generate = program.command("generate");
+    generate
+        .command("<template_name> [version]")
+        .description("Generate a codebase template")
+        .action((templateName, version) => {
+        const finalVersion = version ?? "latest";
+        console.log(`Generating ${templateName} template with version ${finalVersion}`);
+    });
+    generate
+        .command("list")
+        .description("List all available templates")
+        .action(() => {
+        console.log("list of available templates");
+    });
+    generate
+        .command("versions <template_name>")
+        .description("List available versions for a template")
+        .action((templateName) => {
+        console.log(`list of available versions for ${templateName}`);
+    });
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAE7C,QAAQ;SACL,OAAO,CAAC,2BAA2B,CAAC;SACpC,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,CAAC,YAAoB,EAAE,OAAgB,EAAE,EAAE;QACjD,MAAM,YAAY,GAAG,OAAO,IAAI,QAAQ,CAAC;QAEzC,OAAO,CAAC,GAAG,CACT,cAAc,YAAY,0BAA0B,YAAY,EAAE,CACnE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,0BAA0B,CAAC;SACnC,WAAW,CAAC,wCAAwC,CAAC;SACrD,MAAM,CAAC,CAAC,YAAoB,EAAE,EAAE;QAC/B,OAAO,CAAC,GAAG,CAAC,kCAAkC,YAAY,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/install.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerInstallCommands(program: Command): void;
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwD9D"}

package/dist/commands/install.js

@@ -0,0 +1,59 @@
+import { execSync } from "node:child_process";
+import { ensureClyglHome, readInstalledPlugins, resolvePluginPackageName, } from "../plugins/config.js";
+import { readBundledPluginNames } from "../plugins/discover.js";
+function runNpm(args) {
+    execSync(`npm ${args.join(" ")}`, {
+        stdio: "inherit",
+        env: process.env,
+    });
+}
+export function registerInstallCommands(program) {
+    const plugins = program
+        .command("plugins")
+        .description("Manage clygl plugins");
+    plugins
+        .command("list")
+        .description("List installed plugins")
+        .action(() => {
+        ensureClyglHome();
+        const bundled = readBundledPluginNames();
+        const installed = readInstalledPlugins();
+        if (bundled.length > 0) {
+            console.log("Bundled with clygl (default):");
+            for (const plugin of bundled) {
+                console.log(`- ${plugin}`);
+            }
+        }
+        if (installed.length === 0) {
+            console.log("No extra plugins in ~/.clygl.");
+            console.log("Install optional plugins: clygl install generate | hello");
+            return;
+        }
+        console.log("Installed in ~/.clygl:");
+        for (const plugin of installed) {
+            console.log(`- ${plugin}`);
+        }
+    });
+    program
+        .command("install <package>")
+        .description("Install a clygl plugin package")
+        .action((input) => {
+        const clyglHome = ensureClyglHome();
+        const packageName = resolvePluginPackageName(input);
+        console.log(`Installing plugin: ${packageName}`);
+        runNpm(["install", packageName, "--prefix", clyglHome]);
+        console.log(`Installed ${packageName}`);
+        console.log("Run `clygl --help` to see newly available commands.");
+    });
+    program
+        .command("uninstall <package>")
+        .description("Uninstall a clygl plugin package")
+        .action((input) => {
+        const clyglHome = ensureClyglHome();
+        const packageName = resolvePluginPackageName(input);
+        console.log(`Uninstalling plugin: ${packageName}`);
+        runNpm(["uninstall", packageName, "--prefix", clyglHome]);
+        console.log(`Uninstalled ${packageName}`);
+    });
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,SAAS,MAAM,CAAC,IAAc;IAC5B,QAAQ,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;QAChC,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAEvC,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,wBAAwB,CAAC;SACrC,MAAM,CAAC,GAAG,EAAE;QACX,eAAe,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;QAEzC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;YAC7C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CAAC,CAAC,KAAa,EAAE,EAAE;QACxB,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAEpD,OAAO,CAAC,GAAG,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC;QACjD,MAAM,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,aAAa,WAAW,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,CAAC,KAAa,EAAE,EAAE;QACxB,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAEpD,OAAO,CAAC,GAAG,CAAC,wBAAwB,WAAW,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,eAAe,WAAW,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { registerInstallCommands } from "./commands/install.js";
+import { loadPlugins } from "./plugins/loader.js";
+const program = new Command();
+program
+    .name("clygl")
+    .description("A modular CLI dev tool")
+    .version("1.0.0");
+registerInstallCommands(program);
+const loadedPlugins = await loadPlugins(program);
+if (process.env.CLYGL_DEBUG_PLUGINS === "1") {
+    console.error(loadedPlugins.length > 0
+        ? `Loaded plugins: ${loadedPlugins.join(", ")}`
+        : "No plugins loaded.");
+}
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,wBAAwB,CAAC;KACrC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAEjC,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;AAEjD,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG,EAAE,CAAC;IAC5C,OAAO,CAAC,KAAK,CACX,aAAa,CAAC,MAAM,GAAG,CAAC;QACtB,CAAC,CAAC,mBAAmB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC/C,CAAC,CAAC,oBAAoB,CACzB,CAAC;AACJ,CAAC;AAED,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/plugins/config.d.ts

@@ -0,0 +1,5 @@
+export declare const CLYGL_HOME: string;
+export declare function ensureClyglHome(): string;
+export declare function resolvePluginPackageName(input: string): string;
+export declare function readInstalledPlugins(): string[];
+//# sourceMappingURL=config.d.ts.map

package/dist/plugins/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/plugins/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,QAA4B,CAAC;AAEpD,wBAAgB,eAAe,IAAI,MAAM,CAexC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU9D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAY/C"}

package/dist/plugins/config.js

@@ -0,0 +1,32 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const CLYGL_HOME = join(homedir(), ".clygl");
+export function ensureClyglHome() {
+    if (!existsSync(CLYGL_HOME)) {
+        mkdirSync(CLYGL_HOME, { recursive: true });
+    }
+    const manifestPath = join(CLYGL_HOME, "package.json");
+    if (!existsSync(manifestPath)) {
+        writeFileSync(manifestPath, JSON.stringify({ name: "clygl-plugins", private: true }, null, 2));
+    }
+    return CLYGL_HOME;
+}
+export function resolvePluginPackageName(input) {
+    if (input.startsWith(".") || input.startsWith("/") || input.includes(":\\")) {
+        return input;
+    }
+    if (input.startsWith("@")) {
+        return input;
+    }
+    return `@clygl/plugin-${input}`;
+}
+export function readInstalledPlugins() {
+    const manifestPath = join(CLYGL_HOME, "package.json");
+    if (!existsSync(manifestPath)) {
+        return [];
+    }
+    const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+    return Object.keys(manifest.dependencies ?? {}).sort();
+}
+//# sourceMappingURL=config.js.map

package/dist/plugins/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/plugins/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAEpD,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAEtD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,aAAa,CACX,YAAY,EACZ,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAClE,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,iBAAiB,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAEtD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAE7D,CAAC;IAEF,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACzD,CAAC"}

package/dist/plugins/discover.d.ts

@@ -0,0 +1,6 @@
+import type { ClyglPluginManifest } from "../types/plugin.js";
+export declare function getBundledPluginsDir(): string;
+export declare function readPackageManifest(packageDir: string): ClyglPluginManifest | null;
+export declare function collectPluginDirs(modulesDir: string): string[];
+export declare function readBundledPluginNames(): string[];
+//# sourceMappingURL=discover.d.ts.map

package/dist/plugins/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/plugins/discover.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,GACjB,mBAAmB,GAAG,IAAI,CAQ5B;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CA8B9D;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAKjD"}

package/dist/plugins/discover.js

@@ -0,0 +1,44 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+export function getBundledPluginsDir() {
+    return join(dirname(fileURLToPath(import.meta.url)), "..", "..", "bundled-plugins");
+}
+export function readPackageManifest(packageDir) {
+    const manifestPath = join(packageDir, "package.json");
+    if (!existsSync(manifestPath)) {
+        return null;
+    }
+    return JSON.parse(readFileSync(manifestPath, "utf8"));
+}
+export function collectPluginDirs(modulesDir) {
+    if (!existsSync(modulesDir)) {
+        return [];
+    }
+    const pluginDirs = [];
+    for (const entry of readdirSync(modulesDir, { withFileTypes: true })) {
+        if (entry.name.startsWith(".")) {
+            continue;
+        }
+        if (entry.name.startsWith("@")) {
+            const scopeDir = join(modulesDir, entry.name);
+            for (const scopedEntry of readdirSync(scopeDir, { withFileTypes: true })) {
+                if (scopedEntry.isDirectory() || scopedEntry.isSymbolicLink()) {
+                    pluginDirs.push(join(scopeDir, scopedEntry.name));
+                }
+            }
+            continue;
+        }
+        if (entry.isDirectory() || entry.isSymbolicLink()) {
+            pluginDirs.push(join(modulesDir, entry.name));
+        }
+    }
+    return pluginDirs;
+}
+export function readBundledPluginNames() {
+    return collectPluginDirs(getBundledPluginsDir())
+        .map((dir) => readPackageManifest(dir)?.name)
+        .filter((name) => Boolean(name))
+        .sort();
+}
+//# sourceMappingURL=discover.js.map

package/dist/plugins/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/plugins/discover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAAkB;IAElB,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAEtD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAwB,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAE9C,KAAK,MAAM,WAAW,IAAI,WAAW,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBACzE,IAAI,WAAW,CAAC,WAAW,EAAE,IAAI,WAAW,CAAC,cAAc,EAAE,EAAE,CAAC;oBAC9D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;YAED,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;YAClD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,iBAAiB,CAAC,oBAAoB,EAAE,CAAC;SAC7C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;SAC5C,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC/C,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function loadPlugins(program: Command): Promise<string[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyCzC,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsBrE"}

package/dist/plugins/loader.js

@@ -0,0 +1,40 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { CLYGL_HOME, ensureClyglHome } from "./config.js";
+import { collectPluginDirs, getBundledPluginsDir, readPackageManifest, } from "./discover.js";
+async function loadPlugin(program, packageDir) {
+    const manifest = readPackageManifest(packageDir);
+    if (!manifest?.clyglPlugin) {
+        return null;
+    }
+    const entryFile = join(packageDir, manifest.main ?? "index.js");
+    if (!existsSync(entryFile)) {
+        throw new Error(`Plugin "${manifest.name}" is missing entry file: ${entryFile}`);
+    }
+    const pluginModule = (await import(pathToFileURL(entryFile).href));
+    if (typeof pluginModule.register !== "function") {
+        throw new Error(`Plugin "${manifest.name}" must export a register(program) function`);
+    }
+    pluginModule.register(program);
+    return manifest.name;
+}
+export async function loadPlugins(program) {
+    ensureClyglHome();
+    const userModulesDir = join(CLYGL_HOME, "node_modules");
+    const pluginDirs = [
+        ...collectPluginDirs(getBundledPluginsDir()),
+        ...collectPluginDirs(userModulesDir),
+    ];
+    const loadedPlugins = [];
+    const seen = new Set();
+    for (const packageDir of pluginDirs) {
+        const pluginName = await loadPlugin(program, packageDir);
+        if (pluginName && !seen.has(pluginName)) {
+            seen.add(pluginName);
+            loadedPlugins.push(pluginName);
+        }
+    }
+    return loadedPlugins;
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAGvB,KAAK,UAAU,UAAU,CACvB,OAAgB,EAChB,UAAkB;IAElB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAEjD,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC;IAEhE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,WAAW,QAAQ,CAAC,IAAI,4BAA4B,SAAS,EAAE,CAChE,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAEhE,CAAC;IAEF,IAAI,OAAO,YAAY,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,WAAW,QAAQ,CAAC,IAAI,4CAA4C,CACrE,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/B,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAgB;IAChD,eAAe,EAAE,CAAC;IAElB,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG;QACjB,GAAG,iBAAiB,CAAC,oBAAoB,EAAE,CAAC;QAC5C,GAAG,iBAAiB,CAAC,cAAc,CAAC;KACrC,CAAC;IAEF,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,UAAU,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAEzD,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACrB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/types/plugin.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from "commander";
+export interface ClyglPluginManifest {
+    clyglPlugin?: boolean;
+    name: string;
+    main?: string;
+}
+export type ClyglPluginRegister = (program: Command) => void;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC"}

package/dist/types/plugin.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/types/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "clygl",
+  "version": "1.0.0",
+  "description": "A TypeScript Node.js CLI dev tool",
+  "main": "dist/index.js",
+  "bin": {
+    "clygl": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "bundled-plugins"
+  ],
+  "scripts": {
+    "build": "tsc && node scripts/bundle-default-plugins.mjs",
+    "build:cli": "tsc",
+    "build:plugins": "node scripts/bundle-default-plugins.mjs",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["cli", "devtools", "plugins"],
+  "author": "Mohamad Taufik",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Charlilyyyy/clygl.git"
+  },
+  "homepage": "https://github.com/Charlilyyyy/clygl#readme",
+  "type": "module",
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "commander": "^15.0.0"
+  }
+}