@cyberskill/shared 2.28.0 → 3.1.0

package/dist/node/apollo-server/index.js

@@ -4,3 +4,4 @@ export {
   o as createApolloServer,
   l as expressMiddleware
 };
+//# sourceMappingURL=index.js.map

package/dist/node/apollo-server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/node/cli/index.js

@@ -1,180 +1,125 @@
 #!/usr/bin/env node
-import d from "node:process";
-import { hideBin as G } from "yargs/helpers";
-import R from "yargs/yargs";
-import { runCommand as e, clearAllErrorLists as m, getStoredErrorLists as A, resolveCommands as B } from "../command/command.util.js";
-import { getPackage as N, installDependencies as S } from "../package/package.util.js";
-import { pathExistsSync as I, addGitIgnoreEntry as v, removeSync as C, readFileSync as w, writeFileSync as P } from "../fs/fs.util.js";
-import { resolve as U } from "../path/path.util.js";
-import { CYBERSKILL_CLI as x, command as t, CYBERSKILL_PACKAGE_NAME as h, PATH as s, SIMPLE_GIT_HOOK_JSON as K, createGitHooksConfig as F, AG_KIT_PACKAGE_NAME as u, DOT_AGENT as H } from "../path/path.constant.js";
-import { log as a, catchError as _ } from "../log/log.util.js";
-import { E_IssueType as k } from "../log/log.type.js";
-var i = (n, r, o) => new Promise((l, f) => {
-  var T = (c) => {
-    try {
-      y(o.next(c));
-    } catch (p) {
-      f(p);
-    }
-  }, D = (c) => {
-    try {
-      y(o.throw(c));
-    } catch (p) {
-      f(p);
-    }
-  }, y = (c) => c.done ? l(c.value) : Promise.resolve(c.value).then(T, D);
-  y((o = o.apply(n, r)).next());
-});
-function $() {
+import m from "node:process";
+import { hideBin as M } from "yargs/helpers";
+import _ from "yargs/yargs";
+import { runCommand as n, clearAllErrorLists as g, getStoredErrorLists as L, resolveCommands as b } from "../command/command.util.js";
+import { getPackage as T, installDependencies as w } from "../package/package.util.js";
+import { pathExistsSync as y, addGitIgnoreEntry as f, removeSync as k, readFileSync as v, writeFileSync as D } from "../fs/fs.util.js";
+import { resolve as O } from "../path/path.util.js";
+import { CYBERSKILL_CLI as G, command as i, CYBERSKILL_PACKAGE_NAME as p, PATH as o, SIMPLE_GIT_HOOK_JSON as R, createGitHooksConfig as A, AG_KIT_PACKAGE_NAME as c, DOT_AGENT as B } from "../path/path.constant.js";
+import { log as s, catchError as E } from "../log/log.util.js";
+import { E_IssueType as d } from "../log/log.type.js";
+function N() {
   try {
     return JSON.parse(
-      w(U(__dirname, "../../../package.json"), "utf-8")
+      v(O(__dirname, "../../../package.json"), "utf-8")
     ).version;
-  } catch (n) {
+  } catch {
     return "1.0.0";
   }
 }
-function M() {
-  return i(this, null, function* () {
-    I(s.TS_CONFIG) ? yield e("Performing TypeScript validation", yield t.typescriptCheck()) : a.warn("No TypeScript configuration found. Skipping type check.");
-  });
-}
-function b(n = !1) {
-  return i(this, null, function* () {
-    const r = n ? yield t.eslintFix() : yield t.eslintCheck(), o = n ? "Running ESLint with auto-fix" : "Running ESLint check";
-    try {
-      yield e(o, r, { timeout: 6e4, throwOnError: !0 });
-    } catch (l) {
-      l.code === "ETIMEDOUT" || l.killed || l.signal === "SIGTERM" ? (a.warn("Lint check timed out. Retrying with debug mode enabled..."), d.env.DEBUG = "true", yield e(`${o} (Debug Mode)`, r)) : _(l);
-    }
-  });
-}
-function E(n, r) {
-  if (!r.length)
+async function S() {
+  y(o.TS_CONFIG) ? await n("Performing TypeScript validation", await i.typescriptCheck()) : s.warn("No TypeScript configuration found. Skipping type check.");
+}
+async function h(t = !1) {
+  const a = t ? await i.eslintFix() : await i.eslintCheck(), r = t ? "Running ESLint with auto-fix" : "Running ESLint check";
+  try {
+    await n(r, a, { timeout: 6e4, throwOnError: !0 });
+  } catch (e) {
+    e.code === "ETIMEDOUT" || e.killed || e.signal === "SIGTERM" ? (s.warn("Lint check timed out. Retrying with debug mode enabled..."), m.env.DEBUG = "true", await n(`${r} (Debug Mode)`, a)) : E(e);
+  }
+}
+function u(t, a) {
+  if (!a.length)
     return;
-  const o = n === "Errors" ? "red" : "yellow";
-  a.printBoxedLog(n === "Errors" ? "✖ Errors" : "⚠ Warnings", r, o);
-}
-function g() {
-  return i(this, null, function* () {
-    setTimeout(() => i(null, null, function* () {
-      const n = (yield A()) || [], r = n.filter((l) => l.type === k.Error), o = n.filter((l) => l.type === k.Warning);
-      !r.length && !o.length ? a.printBoxedLog("✔ NO ISSUES FOUND", [], "green") : (E("Warnings", o), E("Errors", r), r.length > 0 && d.exit(1));
-    }), 0);
-  });
-}
-function j() {
-  return i(this, null, function* () {
-    yield m();
-    const n = yield N({ name: h });
-    if (!n.success) {
-      a.error("Failed to retrieve package information. Aborting lint-staged.");
-      return;
-    }
-    n.result.isCurrentProject && (yield e(`Building package: ${h}`, yield t.build())), yield e("Executing lint-staged", yield t.lintStaged()), g();
-  });
-}
-function J() {
-  return i(this, null, function* () {
-    yield e("Inspecting ESLint configuration", yield t.eslintInspect());
-  });
-}
-function V() {
-  return i(this, null, function* () {
-    yield m(), yield M(), yield b(), g();
-  });
-}
-function z() {
-  return i(this, null, function* () {
-    yield m(), yield M(), yield b(!0), g();
-  });
-}
-function W() {
-  return i(this, null, function* () {
-    yield m(), yield e("Validating commit message", yield t.commitLint()), g();
-  });
-}
-function L() {
-  return i(this, null, function* () {
-    yield e("Configuring Git hooks", yield t.configureGitHook()), C(s.GIT_HOOK);
-    const n = yield B(F);
-    P(s.SIMPLE_GIT_HOOKS_JSON, JSON.stringify(n, null, 4)), v(s.GIT_IGNORE, K), yield e("Setting up simple-git-hooks", yield t.simpleGitHooks());
-  });
-}
-function O() {
-  return i(this, null, function* () {
-    try {
-      yield e(`Checking for ${u}`, `pnpm list -g ${u}`);
-    } catch (n) {
-      yield e(`Installing ${u} globally`, `pnpm i -g ${u}`);
-    }
-    I(s.DOT_AGENT) ? yield e("Updating AI agent", "ag-kit update -y") : yield e("Initializing AI agent", "ag-kit init"), v(s.GIT_IGNORE, H);
-  });
-}
-function Y() {
-  return i(this, null, function* () {
-    yield S(), yield L();
-  });
-}
-function q() {
-  return i(this, null, function* () {
-    C(s.NODE_MODULES, s.PNPM_LOCK_YAML), yield e("Pruning pnpm store", yield t.pnpmPruneStore()), yield e("Clearing pnpm cache", yield t.pnpmCleanCache()), yield S(), yield L(), yield O();
-  });
-}
-function Q() {
-  return i(this, null, function* () {
-    yield e("Inspecting project dependencies", yield t.nodeModulesInspect());
-  });
-}
-function X() {
-  return i(this, null, function* () {
-    yield e("Running unit tests", yield t.testUnit());
-  });
-}
-function Z() {
-  return i(this, null, function* () {
-    yield e("Running end-to-end tests", yield t.testE2e());
-  });
-}
-function nn(n) {
-  return i(this, null, function* () {
-    yield e("Creating MongoDB migration", yield t.mongoMigrateCreate(n));
-  });
-}
-function en() {
-  return i(this, null, function* () {
-    yield e("Running MongoDB migrations", yield t.mongoMigrateUp());
-  });
-}
-function tn() {
-  return i(this, null, function* () {
-    yield e("Rolling back MongoDB migration", yield t.mongoMigrateDown());
-  });
-}
-function on() {
-  return i(this, null, function* () {
-    yield e("Starting Storybook development server", yield t.storybookDev());
-  });
-}
-function rn() {
-  return i(this, null, function* () {
-    yield e("Building Storybook", yield t.storybookBuild());
-  });
-}
-i(null, null, function* () {
+  const r = t === "Errors" ? "red" : "yellow";
+  s.printBoxedLog(t === "Errors" ? "✖ Errors" : "⚠ Warnings", a, r);
+}
+async function l() {
+  setTimeout(async () => {
+    const t = await L() || [], a = t.filter((e) => e.type === d.Error), r = t.filter((e) => e.type === d.Warning);
+    !a.length && !r.length ? s.printBoxedLog("✔ NO ISSUES FOUND", [], "green") : (u("Warnings", r), u("Errors", a), a.length > 0 && m.exit(1));
+  }, 0);
+}
+async function P() {
+  await g();
+  const t = await T({ name: p });
+  if (!t.success) {
+    s.error("Failed to retrieve package information. Aborting lint-staged.");
+    return;
+  }
+  t.result.isCurrentProject && await n(`Building package: ${p}`, await i.build()), await n("Executing lint-staged", await i.lintStaged()), l();
+}
+async function U() {
+  await n("Inspecting ESLint configuration", await i.eslintInspect());
+}
+async function x() {
+  await g(), await S(), await h(), l();
+}
+async function K() {
+  await g(), await S(), await h(!0), l();
+}
+async function F() {
+  await g(), await n("Validating commit message", await i.commitLint()), l();
+}
+async function I() {
+  await n("Configuring Git hooks", await i.configureGitHook()), k(o.GIT_HOOK);
+  const t = await b(A);
+  D(o.SIMPLE_GIT_HOOKS_JSON, JSON.stringify(t, null, 4)), f(o.GIT_IGNORE, R), await n("Setting up simple-git-hooks", await i.simpleGitHooks());
+}
+async function C() {
+  try {
+    await n(`Checking for ${c}`, `pnpm list -g ${c}`);
+  } catch {
+    await n(`Installing ${c} globally`, `pnpm i -g ${c}`);
+  }
+  y(o.DOT_AGENT) ? await n("Updating AI agent", "ag-kit update -y") : await n("Initializing AI agent", "ag-kit init"), f(o.GIT_EXCLUDE, B);
+}
+async function H() {
+  await w(), await I();
+}
+async function $() {
+  k(o.NODE_MODULES, o.PNPM_LOCK_YAML), await n("Pruning pnpm store", await i.pnpmPruneStore()), await n("Clearing pnpm cache", await i.pnpmCleanCache()), await w(), await I(), await C();
+}
+async function j() {
+  await n("Inspecting project dependencies", await i.nodeModulesInspect());
+}
+async function J() {
+  await n("Running unit tests", await i.testUnit());
+}
+async function V() {
+  await n("Running end-to-end tests", await i.testE2e());
+}
+async function z(t) {
+  await n("Creating MongoDB migration", await i.mongoMigrateCreate(t));
+}
+async function W() {
+  await n("Running MongoDB migrations", await i.mongoMigrateUp());
+}
+async function Y() {
+  await n("Rolling back MongoDB migration", await i.mongoMigrateDown());
+}
+async function q() {
+  await n("Starting Storybook development server", await i.storybookDev());
+}
+async function X() {
+  await n("Building Storybook", await i.storybookBuild());
+}
+(async () => {
   try {
-    yield R(G(d.argv)).scriptName(x).usage("$0 <command> [options]").command("ai:setup", "Setup AI agent environment", O).command("lint", "Check code for linting issues", V).command("lint:fix", "Fix linting issues automatically", z).command("lint:inspect", "View active ESLint configuration", J).command("lint-staged", "Run lint checks on staged files", j).command("commitlint", "Validate commit message format", W).command("ready", "Initialize project and dependencies", Y).command("reset", "Reset the project and reinstall dependencies", q).command("inspect", "Analyze installed project dependencies", Q).command("test:unit", "Run unit test suite", X).command("test:e2e", "Run end-to-end test suite", Z).command("mongo:migrate:create <name>", "Create a MongoDB migration", (n) => n.positional("name", {
+    await _(M(m.argv)).scriptName(G).usage("$0 <command> [options]").command("ai:setup", "Setup AI agent environment", C).command("lint", "Check code for linting issues", x).command("lint:fix", "Fix linting issues automatically", K).command("lint:inspect", "View active ESLint configuration", U).command("lint-staged", "Run lint checks on staged files", P).command("commitlint", "Validate commit message format", F).command("ready", "Initialize project and dependencies", H).command("reset", "Reset the project and reinstall dependencies", $).command("inspect", "Analyze installed project dependencies", j).command("test:unit", "Run unit test suite", J).command("test:e2e", "Run end-to-end test suite", V).command("mongo:migrate:create <name>", "Create a MongoDB migration", (t) => t.positional("name", {
       describe: "Migration name",
       type: "string"
-    }), (n) => i(null, null, function* () {
-      if (!n.name) {
-        a.error("Migration name is required.");
+    }), async (t) => {
+      if (!t.name) {
+        s.error("Migration name is required.");
         return;
       }
-      yield nn(n.name);
-    })).command("mongo:migrate:up", "Apply all MongoDB migrations", en).command("mongo:migrate:down", "Rollback last MongoDB migration", tn).command("storybook:dev", "Start Storybook development server", on).command("storybook:build", "Build Storybook for production", rn).demandCommand(1, "Please specify a valid command.").strict().help().alias("h", "help").alias("v", "version").version($()).epilog(`💡 Tip: Use "--help" with any command to see options
+      await z(t.name);
+    }).command("mongo:migrate:up", "Apply all MongoDB migrations", W).command("mongo:migrate:down", "Rollback last MongoDB migration", Y).command("storybook:dev", "Start Storybook development server", q).command("storybook:build", "Build Storybook for production", X).demandCommand(1, "Please specify a valid command.").strict().help().alias("h", "help").alias("v", "version").version(N()).epilog(`💡 Tip: Use "--help" with any command to see options
 `).parse();
-  } catch (n) {
-    _(n), d.exit(1);
+  } catch (t) {
+    E(t), m.exit(1);
   }
-});
+})();
+//# sourceMappingURL=index.js.map

package/dist/node/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/node/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport process from 'node:process';\nimport { hideBin } from 'yargs/helpers';\nimport yargs from 'yargs/yargs';\n\nimport type { I_IssueEntry } from '../log/index.js';\n\nimport { clearAllErrorLists, getStoredErrorLists, resolveCommands, runCommand } from '../command/index.js';\nimport { addGitIgnoreEntry, pathExistsSync, readFileSync, removeSync, writeFileSync } from '../fs/index.js';\nimport { catchError, E_IssueType, log } from '../log/index.js';\nimport { getPackage, installDependencies } from '../package/index.js';\nimport { AG_KIT_PACKAGE_NAME, command, createGitHooksConfig, CYBERSKILL_CLI, CYBERSKILL_PACKAGE_NAME, DOT_AGENT, PATH, resolve, SIMPLE_GIT_HOOK_JSON } from '../path/index.js';\n\n/**\n * Retrieves the version from the package.json file.\n * This function reads the package.json file and extracts the version number.\n * If the file cannot be read or parsed, it returns a default version of '1.0.0'.\n *\n * @returns The version string from package.json or '1.0.0' as fallback.\n */\nfunction getVersion(): string {\n    try {\n        const pkg = JSON.parse(\n            readFileSync(resolve(__dirname, '../../../package.json'), 'utf-8'),\n        );\n        return pkg.version;\n    }\n    catch {\n        return '1.0.0';\n    }\n}\n\n/**\n * Performs TypeScript validation if a TypeScript configuration file exists.\n * This function checks for the presence of a TypeScript configuration file\n * and runs TypeScript validation if found. If no configuration is found,\n * it logs a warning and skips the type check.\n *\n * @returns A promise that resolves when the TypeScript validation is complete.\n */\nasync function checkTypescript() {\n    if (pathExistsSync(PATH.TS_CONFIG)) {\n        await runCommand('Performing TypeScript validation', await command.typescriptCheck());\n    }\n    else {\n        log.warn('No TypeScript configuration found. Skipping type check.');\n    }\n}\n\n/**\n * Performs ESLint checking with optional auto-fix functionality.\n * This function runs ESLint checks on the codebase and optionally applies\n * automatic fixes to resolve linting issues.\n *\n * @param fix - Whether to apply automatic fixes to linting issues (default: false).\n * @returns A promise that resolves when the ESLint check is complete.\n */\nasync function checkEslint(fix = false) {\n    const commandToRun = fix ? await command.eslintFix() : await command.eslintCheck();\n    const label = fix ? 'Running ESLint with auto-fix' : 'Running ESLint check';\n\n    try {\n        await runCommand(label, commandToRun, { timeout: 60000, throwOnError: true });\n    }\n    catch (error: any) {\n        if (error.code === 'ETIMEDOUT' || error.killed || error.signal === 'SIGTERM') {\n            log.warn('Lint check timed out. Retrying with debug mode enabled...');\n            process.env['DEBUG'] = 'true';\n            await runCommand(`${label} (Debug Mode)`, commandToRun);\n        }\n        else {\n            catchError(error);\n        }\n    }\n}\n\n/**\n * Prints a formatted list of issues (errors or warnings) to the console.\n * This function displays issues in a boxed format with appropriate color coding\n * based on the issue type. It only displays issues if the list is not empty.\n *\n * @param type - The type of issues to display ('Errors' or 'Warnings').\n * @param list - An array of issue entries to display.\n */\nfunction printIssues(type: 'Errors' | 'Warnings', list: I_IssueEntry[]) {\n    if (!list.length) {\n        return;\n    }\n\n    const color = type === 'Errors' ? 'red' : 'yellow';\n    log.printBoxedLog(type === 'Errors' ? '✖ Errors' : '⚠ Warnings', list, color);\n}\n\n/**\n * Displays the final check results after all validation processes.\n * This function retrieves stored error lists and displays them in a formatted manner.\n * If no errors or warnings are found, it displays a success message. If errors are found,\n * it exits the process with code 1 to indicate failure.\n *\n * @returns A promise that resolves when the results are displayed.\n */\nasync function showCheckResult() {\n    setTimeout(async () => {\n        const allResults = (await getStoredErrorLists()) || [];\n        const errors = allResults.filter(e => e.type === E_IssueType.Error);\n        const warnings = allResults.filter(e => e.type === E_IssueType.Warning);\n\n        if (!errors.length && !warnings.length) {\n            log.printBoxedLog('✔ NO ISSUES FOUND', [], 'green');\n        }\n        else {\n            printIssues('Warnings', warnings);\n            printIssues('Errors', errors);\n\n            if (errors.length > 0) {\n                process.exit(1);\n            }\n        }\n    }, 0);\n}\n\n/**\n * Executes lint-staged to check only staged files.\n * This function runs lint-staged which executes linting tools only on files\n * that are staged for commit. It includes building the package if it's the current project\n * and displays the results after completion.\n *\n * @returns A promise that resolves when lint-staged execution is complete.\n */\nasync function lintStaged() {\n    await clearAllErrorLists();\n    const packageData = await getPackage({ name: CYBERSKILL_PACKAGE_NAME });\n\n    if (!packageData.success) {\n        log.error('Failed to retrieve package information. Aborting lint-staged.');\n        return;\n    }\n\n    if (packageData.result.isCurrentProject) {\n        await runCommand(`Building package: ${CYBERSKILL_PACKAGE_NAME}`, await command.build());\n    }\n\n    await runCommand('Executing lint-staged', await command.lintStaged());\n    showCheckResult();\n}\n\n/**\n * Inspects the ESLint configuration to show active rules and settings.\n * This function runs ESLint inspection to display the current configuration,\n * including which rules are active and their settings.\n *\n * @returns A promise that resolves when the ESLint inspection is complete.\n */\nasync function inspectLint() {\n    await runCommand('Inspecting ESLint configuration', await command.eslintInspect());\n}\n\n/**\n * Performs comprehensive linting checks including TypeScript and ESLint.\n * This function runs both TypeScript validation and ESLint checks in parallel,\n * then displays the combined results.\n *\n * @returns A promise that resolves when all linting checks are complete.\n */\nasync function lintCheck() {\n    await clearAllErrorLists();\n    await checkTypescript();\n    await checkEslint();\n    showCheckResult();\n}\n\n/**\n * Performs comprehensive linting checks with automatic fixes.\n * This function runs both TypeScript validation and ESLint checks with auto-fix\n * in parallel, then displays the combined results.\n *\n * @returns A promise that resolves when all linting checks with fixes are complete.\n */\nasync function lintFix() {\n    await clearAllErrorLists();\n    await checkTypescript();\n    await checkEslint(true);\n    showCheckResult();\n}\n\n/**\n * Validates commit message format using commitlint.\n * This function runs commitlint to check if the current commit message\n * follows the conventional commit format and displays the results.\n *\n * @returns A promise that resolves when commit message validation is complete.\n */\nasync function commitLint() {\n    await clearAllErrorLists();\n    await runCommand('Validating commit message', await command.commitLint());\n    showCheckResult();\n}\n\n/**\n * Sets up Git hooks for automated code quality checks.\n * This function configures Git hooks using simple-git-hooks, creates the necessary\n * configuration files, and updates .gitignore to exclude hook configuration files.\n * It also sets up the hooks to run linting and commit validation automatically.\n *\n * @returns A promise that resolves when Git hook setup is complete.\n */\nasync function gitHookSetup() {\n    await runCommand('Configuring Git hooks', await command.configureGitHook());\n\n    removeSync(PATH.GIT_HOOK);\n\n    const hooks = await resolveCommands(createGitHooksConfig);\n\n    writeFileSync(PATH.SIMPLE_GIT_HOOKS_JSON, JSON.stringify(hooks, null, 4));\n\n    addGitIgnoreEntry(PATH.GIT_IGNORE, SIMPLE_GIT_HOOK_JSON);\n\n    await runCommand('Setting up simple-git-hooks', await command.simpleGitHooks());\n}\n\n/**\n * Sets up the AI agent environment.\n * This function ensures the ag-kit package is installed globally, initializes\n * or updates the AI agent configuration, and adds the agent directory\n * to .gitignore to exclude it from version control.\n *\n * @returns A promise that resolves when the AI agent setup is complete.\n */\nasync function aiSetup() {\n    try {\n        await runCommand(`Checking for ${AG_KIT_PACKAGE_NAME}`, `pnpm list -g ${AG_KIT_PACKAGE_NAME}`);\n    }\n    catch {\n        await runCommand(`Installing ${AG_KIT_PACKAGE_NAME} globally`, `pnpm i -g ${AG_KIT_PACKAGE_NAME}`);\n    }\n\n    if (pathExistsSync(PATH.DOT_AGENT)) {\n        await runCommand('Updating AI agent', 'ag-kit update -y');\n    }\n    else {\n        await runCommand('Initializing AI agent', 'ag-kit init');\n    }\n\n    addGitIgnoreEntry(PATH.GIT_EXCLUDE, DOT_AGENT);\n}\n\n/**\n * Initializes the project with dependencies and Git hooks.\n * This function installs project dependencies and sets up Git hooks for\n * automated code quality checks. It's typically run when setting up a new project.\n *\n * @returns A promise that resolves when project initialization is complete.\n */\nasync function ready() {\n    await installDependencies();\n    await gitHookSetup();\n}\n\n/**\n * Resets the project by removing dependencies and reinstalling them.\n * This function removes node_modules and lock files, cleans the package manager cache,\n * reinstalls dependencies, and sets up Git hooks. It's useful for resolving\n * dependency-related issues.\n *\n * @returns A promise that resolves when project reset is complete.\n */\nasync function reset() {\n    removeSync(PATH.NODE_MODULES, PATH.PNPM_LOCK_YAML);\n    await runCommand('Pruning pnpm store', await command.pnpmPruneStore());\n    await runCommand('Clearing pnpm cache', await command.pnpmCleanCache());\n    await installDependencies();\n    await gitHookSetup();\n    await aiSetup();\n}\n\n/**\n * Inspects project dependencies to analyze their status.\n * This function runs dependency inspection to check for outdated packages,\n * security vulnerabilities, and other dependency-related issues.\n *\n * @returns A promise that resolves when dependency inspection is complete.\n */\nasync function inspect() {\n    await runCommand('Inspecting project dependencies', await command.nodeModulesInspect());\n}\n\n/**\n * Runs the unit test suite.\n * This function executes unit tests using the configured test runner\n * and displays the test results.\n *\n * @returns A promise that resolves when unit tests are complete.\n */\nasync function testUnit() {\n    await runCommand('Running unit tests', await command.testUnit());\n}\n\n/**\n * Runs the end-to-end test suite.\n * This function executes end-to-end tests using the configured test runner\n * and displays the test results.\n *\n * @returns A promise that resolves when end-to-end tests are complete.\n */\nasync function testE2E() {\n    await runCommand('Running end-to-end tests', await command.testE2e());\n}\n\n/**\n * Creates a new MongoDB migration file.\n * This function creates a new migration file with the specified name\n * for database schema changes.\n *\n * @param migrationName - The name for the new migration file.\n * @returns A promise that resolves when the migration file is created.\n */\nasync function mongoMigrateCreate(migrationName: string) {\n    await runCommand('Creating MongoDB migration', await command.mongoMigrateCreate(migrationName));\n}\n\n/**\n * Applies all pending MongoDB migrations.\n * This function runs all pending database migrations to update the database schema\n * to the latest version.\n *\n * @returns A promise that resolves when all migrations are applied.\n */\nasync function mongoMigrateUp() {\n    await runCommand('Running MongoDB migrations', await command.mongoMigrateUp());\n}\n\n/**\n * Rolls back the last applied MongoDB migration.\n * This function reverts the most recent database migration, undoing\n * the last schema change.\n *\n * @returns A promise that resolves when the migration is rolled back.\n */\nasync function mongoMigrateDown() {\n    await runCommand('Rolling back MongoDB migration', await command.mongoMigrateDown());\n}\n\n/**\n * Starts the Storybook development server.\n * This function runs Storybook in development mode, allowing you to\n * view and interact with your component stories in a browser.\n *\n * @returns A promise that resolves when the Storybook dev server is started.\n */\nasync function storybookDev() {\n    await runCommand('Starting Storybook development server', await command.storybookDev());\n}\n\n/**\n * Builds Storybook for production deployment.\n * This function creates a static build of Storybook that can be\n * deployed to a web server or hosting service.\n *\n * @returns A promise that resolves when the Storybook build is complete.\n */\nasync function storybookBuild() {\n    await runCommand('Building Storybook', await command.storybookBuild());\n}\n\n(async () => {\n    try {\n        await yargs(hideBin(process.argv))\n            .scriptName(CYBERSKILL_CLI)\n            .usage('$0 <command> [options]')\n            .command('ai:setup', 'Setup AI agent environment', aiSetup)\n            .command('lint', 'Check code for linting issues', lintCheck)\n            .command('lint:fix', 'Fix linting issues automatically', lintFix)\n            .command('lint:inspect', 'View active ESLint configuration', inspectLint)\n            .command('lint-staged', 'Run lint checks on staged files', lintStaged)\n            .command('commitlint', 'Validate commit message format', commitLint)\n            .command('ready', 'Initialize project and dependencies', ready)\n            .command('reset', 'Reset the project and reinstall dependencies', reset)\n            .command('inspect', 'Analyze installed project dependencies', inspect)\n            .command('test:unit', 'Run unit test suite', testUnit)\n            .command('test:e2e', 'Run end-to-end test suite', testE2E)\n            .command('mongo:migrate:create <name>', 'Create a MongoDB migration', y =>\n                y.positional('name', {\n                    describe: 'Migration name',\n                    type: 'string',\n                }), async (argv) => {\n                    if (!argv.name) {\n                        log.error('Migration name is required.');\n\n                        return;\n                    }\n\n                    await mongoMigrateCreate(argv.name);\n                })\n            .command('mongo:migrate:up', 'Apply all MongoDB migrations', mongoMigrateUp)\n            .command('mongo:migrate:down', 'Rollback last MongoDB migration', mongoMigrateDown)\n            .command('storybook:dev', 'Start Storybook development server', storybookDev)\n            .command('storybook:build', 'Build Storybook for production', storybookBuild)\n            .demandCommand(1, 'Please specify a valid command.')\n            .strict()\n            .help()\n            .alias('h', 'help')\n            .alias('v', 'version')\n            .version(getVersion())\n            .epilog('💡 Tip: Use \"--help\" with any command to see options\\n')\n            .parse();\n    }\n    catch (error) {\n        catchError(error);\n        process.exit(1);\n    }\n})();\n"],"names":["process","hideBin","yargs","runCommand","clearAllErrorLists","getStoredErrorLists","resolveCommands","getPackage","installDependencies","pathExistsSync","addGitIgnoreEntry","removeSync","readFileSync","writeFileSync","resolve","CYBERSKILL_CLI","command","CYBERSKILL_PACKAGE_NAME","PATH","SIMPLE_GIT_HOOK_JSON","createGitHooksConfig","AG_KIT_PACKAGE_NAME","DOT_AGENT","log","catchError","E_IssueType","getVersion","checkTypescript","checkEslint","fix","commandToRun","label","error","printIssues","type","list","color","showCheckResult","allResults","errors","warnings","lintStaged","packageData","inspectLint","lintCheck","lintFix","commitLint","gitHookSetup","hooks","aiSetup","ready","reset","inspect","testUnit","testE2E","mongoMigrateCreate","migrationName","mongoMigrateUp","mongoMigrateDown","storybookDev","storybookBuild","y","argv"],"mappings":"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"}

package/dist/node/command/command.test.unit.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/node/command/command.type.js

@@ -2,3 +2,4 @@ var N = /* @__PURE__ */ ((I) => (I.CLI = "CLI", I.STRING = "STRING", I.FUNCTION
 export {
   N as E_CommandType
 };
+//# sourceMappingURL=command.type.js.map

package/dist/node/command/command.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.type.js","sources":["../../../src/node/command/command.type.ts"],"sourcesContent":["/**\n * Interface representing an ESLint error structure.\n */\nexport interface I_EslintError {\n    filePath: string;\n    messages: Array<{\n        ruleId: string;\n        severity: number;\n        message: string;\n        line: number;\n        column: number;\n    }>;\n}\n\n/**\n * Interface representing the command execution context.\n */\nexport interface I_CommandContext {\n    isCurrentProject: boolean;\n}\n\n/**\n * Interface representing a command with raw flag and command string.\n */\nexport interface I_Command { raw: boolean; cmd: string }\n\n/**\n * Type for a function that generates a command string based on context.\n */\nexport type T_CommandFunction = (context?: I_CommandContext) => string;\n\n/**\n * Type for a command, which can be a string, function that returns a string, or a raw command object.\n */\nexport type T_Command = string | T_CommandFunction | I_Command;\n\n/**\n * Type for a command map input, which can be a record or a function returning a record.\n */\nexport type T_CommandMapInput = Record<string, T_Command> | ((context: I_CommandContext) => Record<string, T_Command>);\n\n/**\n * Enum for command types: CLI, STRING, or FUNCTION.\n */\nexport enum E_CommandType {\n    CLI = 'CLI',\n    STRING = 'STRING',\n    FUNCTION = 'FUNCTION',\n}\n"],"names":["E_CommandType"],"mappings":"AA4CO,IAAKA,sBAAAA,OACRA,EAAA,MAAM,OACNA,EAAA,SAAS,UACTA,EAAA,WAAW,YAHHA,IAAAA,KAAA,CAAA,CAAA;"}