@a5gard/asgard 0.0.1

package/src/commands/view-timeline.js

@@ -0,0 +1,43 @@
+import { Command } from '@oclif/core';
+import { execSync } from 'child_process';
+import ora from 'ora';
+import { boxStart, boxDivider, boxEnd, boxLine } from '../utils/box.js';
+
+export default class ViewTimeline extends Command {
+  static description = 'Show all workspaces in your project';
+
+  async run() {
+    const cwd = process.cwd();
+    boxStart('View Timeline');
+    
+    const spinner = ora('Loading workspaces...').start();
+
+    try {
+      const current = execSync('git branch --show-current', { cwd, encoding: 'utf8' }).trim();
+      const branchesRaw = execSync('git branch --format="%(refname:short)"', { cwd, encoding: 'utf8' }).trim();
+      const branches = branchesRaw ? branchesRaw.split('\n') : [];
+      
+      spinner.stop();
+
+      boxLine('Available Workspaces:');
+      boxDivider();
+      
+      branches.forEach(branch => {
+        if (branch === current) {
+          boxLine(`* ${branch} (current)`, 'success');
+        } else {
+          boxLine(`   ${branch}`, 'info');
+        }
+      });
+
+      boxDivider();
+      boxEnd(true, 'Complete');
+    } catch (error) {
+      spinner.stop();
+      const msg = error.stderr ? error.stderr.toString() : error.message;
+      boxLine(msg, 'error');
+      boxDivider();
+      boxEnd(false, 'Failed to load workspaces');
+    }
+  }
+}

package/src/commands/view-versions.js

@@ -0,0 +1,50 @@
+import { Command } from '@oclif/core';
+import { execSync } from 'child_process';
+import ora from 'ora';
+import { boxStart, boxDivider, boxEnd, boxLine } from '../utils/box.js';
+
+export default class ViewVersions extends Command {
+  static description = 'Show all labeled versions of your project';
+
+  async run() {
+    const cwd = process.cwd();
+    boxStart('View Versions');
+    
+    const spinner = ora('Loading versions...').start();
+
+    try {
+      let tags = [];
+      try {
+        const tagsRaw = execSync('git tag', { cwd, encoding: 'utf8' }).trim();
+        tags = tagsRaw ? tagsRaw.split('\n') : [];
+      } catch (e) {
+        tags = [];
+      }
+
+      spinner.stop();
+
+      if (tags.length === 0) {
+        boxLine('No versions found', 'warning');
+        boxDivider();
+        boxEnd(false, 'No versions available');
+        return;
+      }
+
+      boxLine('Labeled Versions:');
+      boxDivider();
+      
+      tags.forEach(tag => {
+        boxLine(`   ${tag}`, 'info');
+      });
+
+      boxDivider();
+      boxEnd(true, 'Complete');
+    } catch (error) {
+      spinner.stop();
+      const msg = error.stderr ? error.stderr.toString() : error.message;
+      boxLine(msg, 'error');
+      boxDivider();
+      boxEnd(false, 'Failed to load versions');
+    }
+  }
+}

package/src/git/helpers.js

@@ -0,0 +1,333 @@
+import simpleGit from 'simple-git';
+import ora from 'ora';
+import { success, error } from '../utils/box.js';
+import inquirer from 'inquirer';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { execSync } from 'child_process';
+import chalk from 'chalk';
+
+
+export async function bumpVersion(releaseType = 'patch') {
+  const packagePath = path.resolve(process.cwd(), 'package.json');
+
+    const cwd = process.cwd();
+    const configPath = path.join(cwd, 'config.asgard');
+    let packageManager = 'pnpm';
+
+    if (fs.existsSync(configPath)) {
+      const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+      packageManager = config.packageManager || 'pnpm';
+    }
+
+
+
+  execSync(`${packageManager} version ${releaseType}`, { cwd, stdio: 'inherit' });
+  execSync(`git push`, { cwd, stdio: 'inherit' });
+  execSync(`git push --tags`, { cwd, stdio: 'inherit' });
+}
+
+
+export async function addCommitPush(message) {
+  const spinner = ora('Saving changes...').start();
+  const cwd = process.cwd();
+
+  try {
+    spinner.text = 'Staging changes...';
+    execSync('git add .', { cwd });
+
+    spinner.text = 'Committing...';
+    // We use a check to see if there are actually changes to avoid "nothing to commit" errors
+    execSync(`git commit -m "${message}"`, { cwd, stdio: 'pipe' });
+
+    spinner.text = 'Pushing to remote...';
+    execSync('git push', { cwd, stdio: 'pipe' });
+
+    spinner.stop();
+    return true;
+  } catch (err) {
+    spinner.stop();
+    // If the error is just "nothing to commit", we can handle it gracefully
+    if (err.stdout && err.stdout.toString().includes('nothing to commit')) {
+      return true; 
+    }
+    throw new Error(err.stderr ? err.stderr.toString() : err.message);
+  }
+}
+export async function downloadFolder(repoUrl, folder, branch = 'main') {
+  const spinner = ora('Downloading folder').start();
+  const git = simpleGit();
+  const tempDir = `.temp-${Date.now()}`;
+
+  try {
+    await git.init(tempDir);
+    await git.cwd(tempDir);
+    await git.addRemote('origin', repoUrl);
+    await git.addConfig('core.sparseCheckout', 'true');
+
+    const sparseCheckoutPath = `${tempDir}/.git/info/sparse-checkout`;
+    await Bun.write(sparseCheckoutPath, folder);
+
+    spinner.text = 'Pulling folder';
+    await git.pull('origin', branch);
+
+    spinner.stop();
+    success(`Folder downloaded to: ${tempDir}`);
+    return tempDir;
+  } catch (err) {
+    spinner.stop();
+    error(`Failed to download folder: ${err.message}`);
+    return null;
+  }
+}
+
+export async function downloadFolderRaw(owner, repo, folder, branch = 'main') {
+  const spinner = ora('Downloading folder (raw)').start();
+
+  try {
+    const apiUrl = `https://api.github.com/repos/${owner}/${repo}/contents/${folder}?ref=${branch}`;
+    const response = await fetch(apiUrl);
+    const files = await response.json();
+
+    if (!Array.isArray(files)) {
+      throw new Error('Not a folder');
+    }
+
+    const targetDir = `./${folder.split('/').pop()}`;
+    await Bun.write(`${targetDir}/.gitkeep`, '');
+
+    for (const file of files) {
+      if (file.type === 'file') {
+        const fileResponse = await fetch(file.download_url);
+        const content = await fileResponse.text();
+        await Bun.write(`${targetDir}/${file.name}`, content);
+      }
+    }
+
+    spinner.stop();
+    success(`Folder downloaded to: ${targetDir}`);
+    return targetDir;
+  } catch (err) {
+    spinner.stop();
+    error(`Failed to download folder: ${err.message}`);
+    return null;
+  }
+}
+
+export async function downloadFile(owner, repo, filePath, branch = 'main') {
+  const spinner = ora('Downloading file').start();
+
+  try {
+    const url = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${filePath}`;
+    const response = await fetch(url);
+
+    if (!response.ok) {
+      throw new Error('File not found');
+    }
+
+    const content = await response.text();
+    const fileName = filePath.split('/').pop();
+    await Bun.write(`./${fileName}`, content);
+
+    spinner.stop();
+    success(`File downloaded: ${fileName}`);
+    return fileName;
+  } catch (err) {
+    spinner.stop();
+    error(`Failed to download file: ${err.message}`);
+    return null;
+  }
+}
+
+
+export async function cloneRepo(repoUrl, targetDir = '') {
+  const spinner = ora(`Cloning ${repoUrl}...`).start();
+  try {
+    // Git handles the URL parsing and directory creation itself
+    execSync(`git clone ${repoUrl} ${targetDir}`, { stdio: 'pipe' });
+    spinner.stop();
+    return true;
+  } catch (err) {
+    spinner.stop();
+    throw new Error(err.stderr ? err.stderr.toString() : err.message);
+  }
+}
+
+export async function ensureGitConfig() {
+  const cwd = process.cwd();
+
+  try {
+    execSync('git config user.name', { stdio: 'ignore' });
+    execSync('git config user.email', { stdio: 'ignore' });
+  } catch (e) {
+    const gitAnswers = await inquirer.prompt([
+      { type: 'input', name: 'name', message: 'Git username:', validate: i => i.length > 0 },
+      { type: 'input', name: 'email', message: 'Git email:', validate: i => i.includes('@') }
+    ]);
+    
+    execSync(`git config --global user.name "${gitAnswers.name}"`, { cwd });
+    execSync(`git config --global user.email "${gitAnswers.email}"`, { cwd });
+  }
+
+}
+export function getGitHubToken() {
+  try {
+    return execSync('gh auth token', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] }).trim();
+  } catch {
+    const envToken = process.env.GITHUB_TOKEN;
+    if (!envToken) {
+      console.error(chalk.red('GitHub token not found. Run: gh auth login'));
+      process.exit(1);
+    }
+    return envToken;
+  }
+}
+
+export function getLicenseContent(type, owner) {
+  const year = new Date().getFullYear();
+
+  const licenses = {
+    'MIT': `MIT License
+
+Copyright (c) ${year} ${owner}
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.`,
+
+    'Apache-2.0': `Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright ${year} ${owner}
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.`,
+
+    'GPL-3.0': `GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) ${year} ${owner}
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.`,
+
+    'BSD-3-Clause': `BSD 3-Clause License
+
+Copyright (c) ${year}, ${owner}
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.`,
+
+    'ISC': `ISC License
+
+Copyright (c) ${year}, ${owner}
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.`
+  };
+
+  return licenses[type] || licenses['MIT'];
+}
+/**The short answer is: **Not with a standard `git clone`.** When you clone, Git is designed to grab the entire history of the repository. However, if you are looking to save space or time, there is a modern workflow called **Sparse Checkout** that allows you to tell Git, "I only want to see these specific folders."
+
+Here is how you can achieve this without downloading the entire project’s history and files.
+
+---
+
+## The "Sparse Checkout" Method
+
+This is the most efficient way to handle this in modern Git (version 2.25 or later). It downloads the repository data but only "checks out" (shows) the folders you care about.
+
+1. **Initialize the repo locally:**
+`git clone --filter=blob:none --sparse <url>`
+*The `--filter=blob:none` flag tells Git not to download the actual file contents until you ask for them.*
+2. **Navigate into the folder:**
+`cd <repo-name>`
+3. **Set the specific folder you want:**
+`git sparse-checkout set <path/to/folder>`
+
+---
+
+## Comparison of Approaches
+
+| Method | Best For... | Pros | Cons |
+| --- | --- | --- | --- |
+| **Standard Clone** | Small projects | Simple, one command | Downloads everything |
+| **Sparse Checkout** | Monorepos | Saves disk space, very fast | Requires a few extra commands |
+| **Shallow Clone** | Quick CI/CD builds | Fastest download | No commit history (`--depth 1`) |
+
+---
+
+## A Simpler Alternative: GitHub Web
+
+If you don't actually need to *code* and just need the files once, tools like **DownGit** or simply using the **GitHub CLI** can sometimes be faster than messing with Git commands.
+
+> **Tip:** If you're on GitHub, you can also press the `.` key while viewing the repo in your browser to open the web editor. From there, you can right-click and download specific files without cloning anything.
+
+Would you like me to walk you through the exact commands for a specific folder path you have in mind? */

package/src/git/sync-repo.js

@@ -0,0 +1,16 @@
+import fs from 'fs-extra';
+import path from 'path';
+import simpleGit from 'simple-git';
+import { execSync } from 'child_process';
+
+export async function syncRepo() {
+  try {
+    const cwd = process.cwd();
+    execSync('git add .', { cwd, stdio: 'inherit' });
+    execSync('git commit -m "Syncing local repo with remote" || true', { cwd, stdio: 'inherit' });
+    execSync('git pull --rebase', { cwd, stdio: 'inherit' });
+    execSync('git push', { cwd, stdio: 'inherit' });
+  } catch (error) {
+    throw new Error(`Sync failed on branch detection/sync: ${error.message}`);
+  }
+}

package/src/index.js

@@ -0,0 +1,2 @@
+// src/index.js
+export { default as run } from '@oclif/core';