@orxataguy/tyr 1.0.23 → 1.0.25

package/bin/tyr.js

@@ -8,7 +8,6 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const packageRoot = resolve(__dirname, '..');
 
-// Locate tsx's CLI entry directly from its package.json — no shell, no .cmd wrappers
 const tsxPkg = JSON.parse(readFileSync(join(packageRoot, 'node_modules', 'tsx', 'package.json'), 'utf-8'));
 const tsxBinField = tsxPkg.bin;
 const tsxBinRelative = typeof tsxBinField === 'string' ? tsxBinField : (tsxBinField.tsx ?? tsxBinField['tsx']);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orxataguy/tyr",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "type": "module",
   "bin": {
     "tyr": "./bin/tyr.js"

package/src/core/Kernel.ts

@@ -22,10 +22,6 @@ interface TyrConfig {
 export interface TyrContext {
     frameworkRoot: string;
     userRoot: string;
-    logger: any;
-    shell: any;
-    fs: any;
-    docker?: any;
     run: (commandName: string, args?: string[]) => Promise<void>;
     task: <T>(description: string, action: () => Promise<T> | T, next?: boolean, onFail?: () => void) => Promise<T | undefined>;
     fail: (msg: string, suggestion?: string) => never;
@@ -54,12 +50,10 @@ export class Kernel {
     public async boot(args: string[]): Promise<void> {
         const isDebug = args.includes('--debug');
 
-        // Load all env vars from ~/.tyr/.env once, before anything else
         (dotenv as any).config({ path: path.join(this.userRoot, '.env'), quiet: true });
 
         await this.container.init(isDebug);
 
-        // All commands live in ~/.tyr/map.yml — the framework ships no runtime commands
         this.config = { commands: {}, aliases: {} };
 
         const userConfigPath = path.join(this.userRoot, 'map.yml');
@@ -67,7 +61,6 @@ export class Kernel {
             try {
                 const raw = yaml.load(fs.readFileSync(userConfigPath, 'utf8')) as TyrConfig;
                 for (const [name, cmdPath] of Object.entries(raw.commands ?? {})) {
-                    // Absolute paths used as-is; relative paths resolved from userRoot
                     this.config.commands[name] = path.isAbsolute(cmdPath)
                         ? cmdPath
                         : path.resolve(this.userRoot, cmdPath);
@@ -91,7 +84,6 @@ export class Kernel {
             return;
         }
 
-        // --version / -v
         if (commandName === '--version' || commandName === '-v') {
             const pkgPath = path.resolve(this.frameworkRoot, 'package.json');
             const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
@@ -99,7 +91,6 @@ export class Kernel {
             return;
         }
 
-        // --update: pull latest changes from the linked ~/.tyr git repo
         if (commandName === '--update') {
             const shell = this.container.get().shell;
             const gitDir = path.join(this.userRoot, '.git');
@@ -115,7 +106,6 @@ export class Kernel {
             return;
         }
 
-        // --upgrade: update the Tyr npm package itself
         if (commandName === '--upgrade') {
             const pkgPath = path.resolve(this.frameworkRoot, 'package.json');
             const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
@@ -126,7 +116,6 @@ export class Kernel {
             return;
         }
 
-        // --help / -h: lists all available commands with their documentation
         if (commandName === '--help' || commandName === '-h') {
             const helpContext = {
                 ...this.container.get(),
@@ -168,7 +157,6 @@ export class Kernel {
             fail: (msg: string, suggestion?: string) => { throw new TyrError(msg, null, suggestion, commandName); }
         };
 
-        // --config (needs context for fs/logger)
         if (commandName === '--config') {
             await config(context)(args.slice(1));
             return;
@@ -202,12 +190,10 @@ export class Kernel {
         }
 
         try {
-            // Absolute paths (user commands) are used directly; relative paths resolve from frameworkRoot
             const absolutePath = path.isAbsolute(scriptPath)
                 ? scriptPath
                 : path.resolve(this.frameworkRoot, scriptPath);
 
-            // Convert to file:// URL — required by ESM on Windows for absolute paths
             const moduleUrl = pathToFileURL(absolutePath).href;
             const module = await import(moduleUrl);
 

package/src/core/sys/config.ts

@@ -75,7 +75,7 @@ const TSCONFIG_TEMPLATE = `{
   "compilerOptions": {
     "target": "ESNext",
     "module": "ESNext",
-    "moduleResolution": "node",
+    "moduleResolution": "bundler",
     "esModuleInterop": true,
     "strict": true,
     "allowSyntheticDefaultImports": true,
@@ -86,8 +86,7 @@ const TSCONFIG_TEMPLATE = `{
 }
 `;
 
-const ENV_TEMPLATE = `# ~/.tyr/.env
-# Environment variables for Tyr. This file must never be committed to git.
+const ENV_TEMPLATE = `# Environment variables for Tyr. This file must never be committed to git.
 #
 # SQL Server database
 MSSQL_USER=
@@ -99,8 +98,7 @@ MONGO_URI=
 MONGO_DATABASE=
 `;
 
-const SH_ALIASES_TEMPLATE = `# ~/.tyr/aliases
-# Add your custom aliases here.
+const SH_ALIASES_TEMPLATE = `# Add your custom aliases here.
 # This file is loaded automatically by your shell.
 #
 # Examples:
@@ -108,30 +106,34 @@ const SH_ALIASES_TEMPLATE = `# ~/.tyr/aliases
 #   alias tyr-deploy='tyr deploy'
 `;
 
-const SH_PLUGINS_TEMPLATE = `# ~/.tyr/plugins
-# Add your shell plugins here.
+const SH_PLUGINS_TEMPLATE = `# Add your shell plugins here.
 # Compatible with zsh, bash and other POSIX shells.
 #
 # Examples (zsh):
 #   source /usr/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh
 `;
 
-const PS_ALIASES_TEMPLATE = `# ~/.tyr/aliases.ps1
-# Add your custom aliases for PowerShell here.
+const PS_ALIASES_TEMPLATE = `# Add your custom aliases for PowerShell here.
 #
 # Examples:
 #   Set-Alias gs git-status
 #   function tyr-deploy { tyr deploy @args }
 `;
 
-const PS_PLUGINS_TEMPLATE = `# ~/.tyr/plugins.ps1
-# Add your PowerShell modules and plugins here.
+const PS_PLUGINS_TEMPLATE = `# Add your PowerShell modules and plugins here.
 #
 # Examples:
 #   Import-Module posh-git
 #   Import-Module PSReadLine
 `;
 
+const GIT_IGNORE = `# ENVIRONMENT
+.env
+
+# NODE 
+node_modules
+`;
+
 function makeTimestamp(): string {
     const now = new Date();
     const pad = (n: number) => String(n).padStart(2, '0');
@@ -239,11 +241,17 @@ export default function config({ logger, fs: tyrFs, frameworkRoot, shell }: TyrC
             await tyrFs.write(mapPath, 'commands: {}\n');
             logger.success(`File created: ${mapPath}`);
 
-            const envPath = path.join(userRoot, '.env');
+            const envPath = path.join(userRoot, '.env.example');
             if (!tyrFs.exists(envPath)) {
                 await tyrFs.write(envPath, ENV_TEMPLATE);
                 logger.success(`File created: ${envPath}`);
             }
+            
+            const gitignorePath = path.join(userRoot, '.gitignore');
+            if (!tyrFs.exists(gitignorePath)) {
+                await tyrFs.write(gitignorePath, GIT_IGNORE);
+                logger.success(`File created: ${gitignorePath}`);
+            }
 
             const packageJsonPath = path.join(userRoot, 'package.json');
             if (!tyrFs.exists(packageJsonPath)) {

package/src/core/sys/gen.ts

@@ -47,7 +47,6 @@ export default function gen({ logger, fs, userRoot }: TyrContext) {
         const templateFilled = template.replaceAll('%s', commandName);
         await fs.write(filePath, templateFilled.trim());
 
-        // Register in ~/.tyr/map.yml
         const mapPath = path.join(userRoot, 'map.yml');
         try {
             const currentConfigRaw = await fs.read(mapPath);
@@ -59,7 +58,6 @@ export default function gen({ logger, fs, userRoot }: TyrContext) {
                 logger.warn(`Command '${commandName}' already existed. Updating path...`);
             }
 
-            // Store path relative to userRoot so it remains portable
             config.commands[commandName] = `./commands/${fileName}.tyr.ts`;
 
             const newYaml = yaml.dump(config, { indent: 2, lineWidth: -1 });

package/src/core/sys/help.ts

@@ -8,10 +8,6 @@ interface CommandDoc {
     usage: string;
 }
 
-/**
- * Extracts the first JSDoc block from a .tyr.ts file and parses it
- * into a description and usage examples.
- */
 function parseCommandDoc(filePath: string): CommandDoc {
     const fileName = path.basename(filePath, '.tyr.ts');
     const content = fs.readFileSync(filePath, 'utf-8');
@@ -21,12 +17,10 @@ function parseCommandDoc(filePath: string): CommandDoc {
         return { name: fileName, description: '', usage: '' };
     }
 
-    // Clean each line: remove leading * and spaces
     const lines = match[1]
         .split('\n')
         .map(line => line.replace(/^\s*\*\s?/, '').trimEnd());
 
-    // Split into description and "Usage:" block
     const usoIndex = lines.findIndex(l => /^uso:/i.test(l.trim()));
 
     let description = '';
@@ -74,7 +68,6 @@ export default function help({ userRoot }: TyrContext) {
         console.log(separator);
         console.log('');
 
-        // Framework flags and built-in commands
         const builtins = [
             { name: '--help',    description: 'Shows this command listing.',                  usage: 'tyr --help' },
             { name: '--version', description: 'Shows the installed version of tyr.',          usage: 'tyr --version' },