@cyberskill/shared 2.26.0 → 2.28.0

package/README.md

@@ -256,7 +256,7 @@ import {
     useApolloError,
     useLoading
 } from '@cyberskill/shared';
-import React from 'react';
+import * as React from 'react';
 
 // Main application wrapper
 /**

package/dist/config/config.util.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("@antfu/eslint-config"),i=require("./config.type.cjs"),o=require("./eslint/index.cjs"),l=require("./vitest/vitest.e2e.cjs"),_=require("./vitest/vitest.unit.cjs"),a=require("../util/object/object.util.cjs");var s=Object.getOwnPropertySymbols,u=Object.prototype.hasOwnProperty,y=Object.prototype.propertyIsEnumerable,p=(e,n)=>{var t={};for(var r in e)u.call(e,r)&&n.indexOf(r)<0&&(t[r]=e[r]);if(e!=null&&s)for(var r of s(e))n.indexOf(r)<0&&y.call(e,r)&&(t[r]=e[r]);return t};const E=(...e)=>{const t=a.deepMerge(...Array.isArray(o.default)?o.default:[o.default],...e),{ignores:r}=t,f=p(t,["ignores"]);return g({stylistic:{semi:!0,indent:4,quotes:"single"},formatters:{css:!0,html:!0,markdown:"prettier"},yaml:!1,react:!0},f,...Array.isArray(r)?[{ignores:r}]:[])},T={[i.E_ConfigType.ESLINT]:e=>E(e),[i.E_ConfigType.COMMITLINT]:e=>a.deepMerge(e),[i.E_ConfigType.LINT_STAGED]:e=>a.deepMerge(e),[i.E_ConfigType.VITEST_REACT_UNIT]:e=>_.vitestUnit(e),[i.E_ConfigType.VITEST_REACT_E2E]:e=>l.vitestE2E(e)};function d(e,...n){const t=T[e];if(!n||n.length===0)return t({});if(!t)throw new Error(`Unknown config type: ${e}`);return t(...n)}exports.mergeConfigs=d;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("@antfu/eslint-config"),i=require("./config.type.cjs"),o=require("./eslint/index.cjs"),_=require("./vitest/vitest.e2e.cjs"),l=require("./vitest/vitest.unit.cjs"),a=require("../util/object/object.util.cjs");var f=Object.getOwnPropertySymbols,y=Object.prototype.hasOwnProperty,u=Object.prototype.propertyIsEnumerable,E=(e,n)=>{var t={};for(var r in e)y.call(e,r)&&n.indexOf(r)<0&&(t[r]=e[r]);if(e!=null&&f)for(var r of f(e))n.indexOf(r)<0&&u.call(e,r)&&(t[r]=e[r]);return t};const p=(...e)=>{const t=a.deepMerge(...Array.isArray(o.default)?o.default:[o.default],...e),{ignores:r}=t,g=E(t,["ignores"]);return s({stylistic:{semi:!0,indent:4},formatters:!0,yaml:!1,react:!0},g,...Array.isArray(r)?[{ignores:r}]:[])},T={[i.E_ConfigType.ESLINT]:e=>p(e),[i.E_ConfigType.COMMITLINT]:e=>a.deepMerge(e),[i.E_ConfigType.LINT_STAGED]:e=>a.deepMerge(e),[i.E_ConfigType.VITEST_REACT_UNIT]:e=>l.vitestUnit(e),[i.E_ConfigType.VITEST_REACT_E2E]:e=>_.vitestE2E(e)};function d(e,...n){const t=T[e];if(!n||n.length===0)return t({});if(!t)throw new Error(`Unknown config type: ${e}`);return t(...n)}exports.mergeConfigs=d;

package/dist/config/config.util.js

@@ -1,13 +1,13 @@
-import m from "@antfu/eslint-config";
+import s from "@antfu/eslint-config";
 import { E_ConfigType as o } from "./config.type.js";
 import i from "./eslint/index.js";
-import { vitestE2E as l } from "./vitest/vitest.e2e.js";
-import { vitestUnit as p } from "./vitest/vitest.unit.js";
+import { vitestE2E as p } from "./vitest/vitest.e2e.js";
+import { vitestUnit as g } from "./vitest/vitest.unit.js";
 import { deepMerge as a } from "../util/object/object.util.js";
-var f = Object.getOwnPropertySymbols, g = Object.prototype.hasOwnProperty, E = Object.prototype.propertyIsEnumerable, _ = (r, n) => {
+var f = Object.getOwnPropertySymbols, l = Object.prototype.hasOwnProperty, E = Object.prototype.propertyIsEnumerable, _ = (r, n) => {
   var e = {};
   for (var t in r)
-    g.call(r, t) && n.indexOf(t) < 0 && (e[t] = r[t]);
+    l.call(r, t) && n.indexOf(t) < 0 && (e[t] = r[t]);
   if (r != null && f)
     for (var t of f(r))
       n.indexOf(t) < 0 && E.call(r, t) && (e[t] = r[t]);
@@ -17,33 +17,28 @@ const y = (...r) => {
   const e = a(
     ...Array.isArray(i) ? i : [i],
     ...r
-  ), { ignores: t } = e, s = _(e, ["ignores"]);
-  return m(
+  ), { ignores: t } = e, m = _(e, ["ignores"]);
+  return s(
     {
       stylistic: {
         semi: !0,
-        indent: 4,
-        quotes: "single"
-      },
-      formatters: {
-        css: !0,
-        html: !0,
-        markdown: "prettier"
+        indent: 4
       },
+      formatters: !0,
       yaml: !1,
       react: !0
     },
-    s,
+    m,
     ...Array.isArray(t) ? [{ ignores: t }] : []
   );
 }, T = {
   [o.ESLINT]: (r) => y(r),
   [o.COMMITLINT]: (r) => a(r),
   [o.LINT_STAGED]: (r) => a(r),
-  [o.VITEST_REACT_UNIT]: (r) => p(r),
-  [o.VITEST_REACT_E2E]: (r) => l(r)
+  [o.VITEST_REACT_UNIT]: (r) => g(r),
+  [o.VITEST_REACT_E2E]: (r) => p(r)
 };
-function b(r, ...n) {
+function w(r, ...n) {
   const e = T[r];
   if (!n || n.length === 0)
     return e({});
@@ -52,5 +47,5 @@ function b(r, ...n) {
   return e(...n);
 }
 export {
-  b as mergeConfigs
+  w as mergeConfigs
 };

package/dist/config/eslint/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const i=require("globals");function u(t){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(t){for(const r in t)if(r!=="default"){const o=Object.getOwnPropertyDescriptor(t,r);Object.defineProperty(e,r,o.get?o:{enumerable:!0,get:()=>t[r]})}}return e.default=t,Object.freeze(e)}const n=u(i);var c=Object.defineProperty,a=Object.getOwnPropertySymbols,f=Object.prototype.hasOwnProperty,p=Object.prototype.propertyIsEnumerable,l=(t,e,r)=>e in t?c(t,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[e]=r,s=(t,e)=>{for(var r in e||(e={}))f.call(e,r)&&l(t,r,e[r]);if(a)for(var r of a(e))p.call(e,r)&&l(t,r,e[r]);return t};const d=[{languageOptions:{globals:s(s({},n.node),n.browser)},rules:{"perfectionist/sort-imports":["error",{internalPattern:["^#.*","^@/.*"]}],"dot-notation":"off"},ignores:["**/node_modules/**","**/.git/**","build","dist"]}];exports.default=d;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const i=require("globals");function u(t){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(t){for(const r in t)if(r!=="default"){const o=Object.getOwnPropertyDescriptor(t,r);Object.defineProperty(e,r,o.get?o:{enumerable:!0,get:()=>t[r]})}}return e.default=t,Object.freeze(e)}const n=u(i);var c=Object.defineProperty,a=Object.getOwnPropertySymbols,f=Object.prototype.hasOwnProperty,p=Object.prototype.propertyIsEnumerable,l=(t,e,r)=>e in t?c(t,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[e]=r,s=(t,e)=>{for(var r in e||(e={}))f.call(e,r)&&l(t,r,e[r]);if(a)for(var r of a(e))p.call(e,r)&&l(t,r,e[r]);return t};const d=[{languageOptions:{globals:s(s({},n.node),n.browser)},rules:{"perfectionist/sort-imports":["error",{internalPattern:["^#.*","^@/.*"]}],"dot-notation":"off"},ignores:["**/node_modules/**","**/.git/**","build","dist",".agent"]}];exports.default=d;

package/dist/config/eslint/index.d.ts

@@ -373,6 +373,7 @@ declare const _default: {
             HTMLFormElement: false;
             HTMLFrameElement: false;
             HTMLFrameSetElement: false;
+            HTMLGeolocationElement: false;
             HTMLHeadElement: false;
             HTMLHeadingElement: false;
             HTMLHRElement: false;
@@ -1165,6 +1166,7 @@ declare const _default: {
             XRView: false;
             XRViewerPose: false;
             XRViewport: false;
+            XRVisibilityMaskChangeEvent: false;
             XRWebGLBinding: false;
             XRWebGLDepthInformation: false;
             XRWebGLLayer: false;

package/dist/config/eslint/index.js

@@ -18,7 +18,7 @@ const f = [
       }],
       "dot-notation": "off"
     },
-    ignores: ["**/node_modules/**", "**/.git/**", "build", "dist"]
+    ignores: ["**/node_modules/**", "**/.git/**", "build", "dist", ".agent"]
   }
 ];
 export {

package/dist/config/vitest/vitest.e2e.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@vitejs/plugin-react-swc"),i=require("../../node_modules/.pnpm/vitest@4.0.16_@types_node@25.0.3_jiti@2.6.1_jsdom@27.4.0_sass@1.97.2_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/config.cjs"),o=require("../../util/object/object.util.cjs");function n(e){const r={plugins:[t()],test:{include:["**/*.test.e2e.?(c|m)[jt]s?(x)"],browser:{enabled:!0,provider:"playwright",instances:[{browser:"chromium"},{browser:"firefox"},{browser:"webkit"}]}}};return i.defineConfig(o.deepMerge(r,e))}exports.vitestE2E=n;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@vitejs/plugin-react-swc"),i=require("../../node_modules/.pnpm/vitest@4.0.18_@types_node@25.3.0_jiti@2.6.1_jsdom@28.1.0_@noble_hashes@1.8.0__sass@1.97.3_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/config.cjs"),o=require("../../util/object/object.util.cjs");function n(e){const r={plugins:[t()],test:{include:["**/*.test.e2e.?(c|m)[jt]s?(x)"],browser:{enabled:!0,provider:"playwright",instances:[{browser:"chromium"},{browser:"firefox"},{browser:"webkit"}]}}};return i.defineConfig(o.deepMerge(r,e))}exports.vitestE2E=n;

package/dist/config/vitest/vitest.e2e.js

@@ -1,5 +1,5 @@
 import t from "@vitejs/plugin-react-swc";
-import { defineConfig as o } from "../../node_modules/.pnpm/vitest@4.0.16_@types_node@25.0.3_jiti@2.6.1_jsdom@27.4.0_sass@1.97.2_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/config.js";
+import { defineConfig as o } from "../../node_modules/.pnpm/vitest@4.0.18_@types_node@25.3.0_jiti@2.6.1_jsdom@28.1.0_@noble_hashes@1.8.0__sass@1.97.3_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/config.js";
 import { deepMerge as i } from "../../util/object/object.util.js";
 function m(e) {
   const r = {

package/dist/config/vitest/vitest.unit.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("@vitejs/plugin-react-swc"),n=require("../../node_modules/.pnpm/vitest@4.0.16_@types_node@25.0.3_jiti@2.6.1_jsdom@27.4.0_sass@1.97.2_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/config.cjs"),s=require("../../util/object/object.util.cjs");function r(e){const t={plugins:[i()],test:{globals:!0,environment:"jsdom",pool:"vmThreads",include:["**/*.test.unit.?(c|m)[jt]s?(x)"],setupFiles:["./vitest.unit.setup.ts"]}};return n.defineConfig(s.deepMerge(t,e))}exports.vitestUnit=r;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("@vitejs/plugin-react-swc"),n=require("../../node_modules/.pnpm/vitest@4.0.18_@types_node@25.3.0_jiti@2.6.1_jsdom@28.1.0_@noble_hashes@1.8.0__sass@1.97.3_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/config.cjs"),s=require("../../util/object/object.util.cjs");function r(e){const t={plugins:[i()],test:{globals:!0,environment:"jsdom",pool:"vmThreads",include:["**/*.test.unit.?(c|m)[jt]s?(x)"],setupFiles:["./vitest.unit.setup.ts"]}};return n.defineConfig(s.deepMerge(t,e))}exports.vitestUnit=r;

package/dist/config/vitest/vitest.unit.js

@@ -1,5 +1,5 @@
 import i from "@vitejs/plugin-react-swc";
-import { defineConfig as o } from "../../node_modules/.pnpm/vitest@4.0.16_@types_node@25.0.3_jiti@2.6.1_jsdom@27.4.0_sass@1.97.2_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/config.js";
+import { defineConfig as o } from "../../node_modules/.pnpm/vitest@4.0.18_@types_node@25.3.0_jiti@2.6.1_jsdom@28.1.0_@noble_hashes@1.8.0__sass@1.97.3_tsx@4.21.0_yaml@2.8.2/node_modules/vitest/dist/config.js";
 import { deepMerge as n } from "../../util/object/object.util.js";
 function p(t) {
   const e = {

package/dist/node/cli/index.cjs

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

package/dist/node/cli/index.js

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

package/dist/node/command/command.util.js

@@ -5,7 +5,7 @@ import { storage as y } from "../storage/storage.util.js";
 import { getPackage as B } from "../package/package.util.js";
 import { CYBERSKILL_PACKAGE_NAME as M, PNPM_EXEC_CLI as T, TSX_CLI as O, CYBERSKILL_CLI_PATH as R, CYBERSKILL_CLI as b } from "../path/path.constant.js";
 import { E_IssueType as f } from "../log/log.type.js";
-import { catchError as E, log as h } from "../log/log.util.js";
+import { log as h, catchError as E } from "../log/log.util.js";
 import { getEnv as N } from "../../config/env/env.util.js";
 var a = (r, t, e) => new Promise((s, i) => {
   var o = (u) => {

package/dist/node/fs/fs.util.cjs

@@ -1 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("fs-extra"),d=require("node:path");var p=Object.defineProperty,c=Object.getOwnPropertySymbols,o=Object.prototype.hasOwnProperty,S=Object.prototype.propertyIsEnumerable,l=(e,n,r)=>n in e?p(e,n,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[n]=r,v=(e,n)=>{for(var r in n||(n={}))o.call(n,r)&&l(e,r,n[r]);if(c)for(var r of c(n))S.call(n,r)&&l(e,r,n[r]);return e},m=(e,n)=>{var r={};for(var t in e)o.call(e,t)&&n.indexOf(t)<0&&(r[t]=e[t]);if(e!=null&&c)for(var t of c(e))n.indexOf(t)<0&&S.call(e,t)&&(r[t]=e[t]);return r};const _=i,{lstatSync:O,readdirSync:w,mkdirSync:x,readFileSync:F,unlinkSync:g,statSync:f,createWriteStream:E}=i,h=i.readJsonSync;function P(e,n,r){i.writeFileSync(e,n,r!=null?r:"utf-8")}function b(e,n,r){i.appendFileSync(e,n,r!=null?r:"utf-8")}function s(...e){return e.every(n=>i.pathExistsSync(n))}function j(...e){e.forEach(n=>{s(n)&&i.removeSync(n)})}function J(e,n,r={}){const t=r,{extensions:a}=t,u=m(t,["extensions"]);i.copySync(e,n,v({filter:y=>f(y).isDirectory()||!a||a.length===0?!0:a.includes(d.extname(y))},u))}exports.appendFileSync=b;exports.copySync=J;exports.createWriteStream=E;exports.fs=_;exports.lstatSync=O;exports.mkdirSync=x;exports.pathExistsSync=s;exports.readFileSync=F;exports.readJsonSync=h;exports.readdirSync=w;exports.removeSync=j;exports.statSync=f;exports.unlinkSync=g;exports.writeFileSync=P;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("fs-extra"),m=require("node:path");var _=Object.defineProperty,c=Object.getOwnPropertySymbols,f=Object.prototype.hasOwnProperty,S=Object.prototype.propertyIsEnumerable,l=(n,e,r)=>e in n?_(n,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):n[e]=r,O=(n,e)=>{for(var r in e||(e={}))f.call(e,r)&&l(n,r,e[r]);if(c)for(var r of c(e))S.call(e,r)&&l(n,r,e[r]);return n},g=(n,e)=>{var r={};for(var t in n)f.call(n,t)&&e.indexOf(t)<0&&(r[t]=n[t]);if(n!=null&&c)for(var t of c(n))e.indexOf(t)<0&&S.call(n,t)&&(r[t]=n[t]);return r};const E=i,{lstatSync:w,readdirSync:x,mkdirSync:F,readFileSync:s,unlinkSync:b,statSync:u,createWriteStream:j}=i,h=i.readJsonSync;function d(n,e,r){i.writeFileSync(n,e,r!=null?r:"utf-8")}function p(n,e,r){i.appendFileSync(n,e,r!=null?r:"utf-8")}function y(...n){return n.every(e=>i.pathExistsSync(e))}function J(...n){n.forEach(e=>{y(e)&&i.removeSync(e)})}function P(n,e,r={}){const t=r,{extensions:a}=t,v=g(t,["extensions"]);i.copySync(n,e,O({filter:o=>u(o).isDirectory()||!a||a.length===0?!0:a.includes(m.extname(o))},v))}function k(n,e){const r=`
+${e}
+`;y(n)?s(n,"utf-8").split(`
+`).includes(e)||p(n,r):d(n,r)}exports.addGitIgnoreEntry=k;exports.appendFileSync=p;exports.copySync=P;exports.createWriteStream=j;exports.fs=E;exports.lstatSync=w;exports.mkdirSync=F;exports.pathExistsSync=y;exports.readFileSync=s;exports.readJsonSync=h;exports.readdirSync=x;exports.removeSync=J;exports.statSync=u;exports.unlinkSync=b;exports.writeFileSync=d;

package/dist/node/fs/fs.util.d.ts

@@ -55,3 +55,11 @@ export declare function removeSync(...paths: string[]): void;
  * @param options - Optional copy configuration including extensions filter and other fs-extra options.
  */
 export declare function copySync(src: string, dest: string, options?: I_CopySyncOptions): void;
+/**
+ * Adds an entry to the .gitignore file if it doesn't already exist.
+ * Creates the .gitignore file if it doesn't exist.
+ *
+ * @param gitIgnorePath - The absolute path to the .gitignore file.
+ * @param entry - The entry name to add (e.g. '.agent', '.simple-git-hooks.json').
+ */
+export declare function addGitIgnoreEntry(gitIgnorePath: string, entry: string): void;