@forgehive/forge-cli 0.3.7 → 0.3.9

package/dist/runner.js

@@ -24,6 +24,7 @@ const create_1 = require("./tasks/runner/create");
 const remove_2 = require("./tasks/runner/remove");
 const bundle_1 = require("./tasks/runner/bundle");
 const download_2 = require("./tasks/fixture/download");
+const download_3 = require("./tasks/docs/download");
 const add_1 = require("./tasks/auth/add");
 const switch_1 = require("./tasks/auth/switch");
 const list_2 = require("./tasks/auth/list");
@@ -56,6 +57,8 @@ runner.load('runner:remove', remove_2.remove);
 runner.load('runner:bundle', bundle_1.bundle);
 // Fixture commands
 runner.load('fixture:download', download_2.download);
+// Docs commands
+runner.load('docs:download', download_3.download);
 // Auth commands
 runner.load('auth:add', add_1.add);
 runner.load('auth:switch', switch_1.switchProfile);
@@ -115,9 +118,13 @@ runner.setHandler(async (data) => {
             });
         }
         else if (taskName === 'task:run') {
+            const { input, ...restArgs } = args;
+            // If --input is provided, parse it as JSON and use that
+            // Otherwise, use the regular arguments spread from minimist
+            const taskArgs = input ? JSON.parse(input) : restArgs;
             result = await task.run({
                 descriptorName: action,
-                args
+                args: taskArgs
             });
         }
         else if (taskName === 'fixture:download') {
@@ -142,6 +149,12 @@ runner.setHandler(async (data) => {
                 profileName: action
             });
         }
+        else if (taskName === 'docs:download') {
+            const { path } = args;
+            result = await task.run({
+                path
+            });
+        }
         else {
             result = await task.run(args);
             if (taskName === 'info') {

package/dist/tasks/docs/download.d.ts

@@ -0,0 +1,20 @@
+export declare const download: import("@forgehive/task").TaskInstanceType<(argv: {
+    path?: string | undefined;
+}, boundaries: import("@forgehive/task").WrappedBoundaries<{
+    fetchFile: (url: string) => Promise<string>;
+    getCurrentWorkingDirectory: () => Promise<string>;
+    createDirectory: (dirPath: string) => Promise<void>;
+    writeFile: (filePath: string, content: string) => Promise<void>;
+    checkFileExists: (filePath: string) => Promise<boolean>;
+}>) => Promise<{
+    success: boolean;
+    filePath: string;
+    targetPath: string;
+    size: number;
+}>, {
+    fetchFile: (url: string) => Promise<string>;
+    getCurrentWorkingDirectory: () => Promise<string>;
+    createDirectory: (dirPath: string) => Promise<void>;
+    writeFile: (filePath: string, content: string) => Promise<void>;
+    checkFileExists: (filePath: string) => Promise<boolean>;
+}>;

package/dist/tasks/docs/download.js

@@ -0,0 +1,114 @@
+"use strict";
+// TASK: download
+// Run this task with:
+// forge task:run docs:download
+// forge task:run docs:download --path="custom/path/forge.md"
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.download = void 0;
+const task_1 = require("@forgehive/task");
+const schema_1 = require("@forgehive/schema");
+const path_1 = __importDefault(require("path"));
+const name = 'docs:download';
+const description = 'Download the ForgeHive LLM guide from GitHub to local project';
+const LLM_GUIDE_URL = 'https://raw.githubusercontent.com/forge-and-hive/forge-mono-repo/refs/heads/main/docs/llm.md';
+const schema = new schema_1.Schema({
+    path: schema_1.Schema.string().optional()
+});
+const boundaries = {
+    fetchFile: async (url) => {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch file: ${response.status} ${response.statusText}`);
+        }
+        return await response.text();
+    },
+    getCurrentWorkingDirectory: async () => {
+        return process.cwd();
+    },
+    createDirectory: async (dirPath) => {
+        const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+        await fs.mkdir(dirPath, { recursive: true });
+    },
+    writeFile: async (filePath, content) => {
+        const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+        await fs.writeFile(filePath, content, 'utf-8');
+    },
+    checkFileExists: async (filePath) => {
+        const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+};
+exports.download = (0, task_1.createTask)({
+    name,
+    description,
+    schema,
+    boundaries,
+    fn: async function ({ path: customPath }, { fetchFile, getCurrentWorkingDirectory, createDirectory, writeFile, checkFileExists }) {
+        // Determine the target path
+        const targetPath = customPath || 'docs/forge.md';
+        const cwd = await getCurrentWorkingDirectory();
+        const fullPath = path_1.default.resolve(cwd, targetPath);
+        const dirPath = path_1.default.dirname(fullPath);
+        console.log(`Downloading ForgeHive LLM guide to: ${targetPath}`);
+        // Check if file already exists
+        const fileExists = await checkFileExists(fullPath);
+        if (fileExists) {
+            console.log(`Warning: File already exists at ${targetPath}. It will be overwritten.`);
+        }
+        // Download the file content
+        const content = await fetchFile(LLM_GUIDE_URL);
+        // Create directory if it doesn't exist
+        await createDirectory(dirPath);
+        // Write the file
+        await writeFile(fullPath, content);
+        console.log(`✅ Successfully downloaded ForgeHive LLM guide to ${targetPath}`);
+        return {
+            success: true,
+            filePath: fullPath,
+            targetPath,
+            size: content.length
+        };
+    }
+});

package/forge.json

@@ -114,6 +114,10 @@
     "task:invoke": {
       "path": "src/tasks/task/invoke.ts",
       "handler": "invoke"
+    },
+    "docs:download": {
+      "path": "src/tasks/docs/download.ts",
+      "handler": "download"
     }
   },
   "runners": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgehive/forge-cli",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "TypeScript CLI application",
   "license": "MIT",
   "main": "dist/index.js",

package/src/runner.ts

@@ -27,6 +27,8 @@ import { bundle as bundleRunner } from './tasks/runner/bundle'
 
 import { download as downloadFixture } from './tasks/fixture/download'
 
+import { download as downloadDocs } from './tasks/docs/download'
+
 import { add as addProfile } from './tasks/auth/add'
 import { switchProfile } from './tasks/auth/switch'
 import { list as listProfiles } from './tasks/auth/list'
@@ -70,6 +72,9 @@ runner.load('runner:bundle', bundleRunner)
 // Fixture commands
 runner.load('fixture:download', downloadFixture)
 
+// Docs commands
+runner.load('docs:download', downloadDocs)
+
 // Auth commands
 runner.load('auth:add', addProfile)
 runner.load('auth:switch', switchProfile)
@@ -133,9 +138,15 @@ runner.setHandler(async (data: ParsedArgs): Promise<unknown> => {
         cache
       })
     } else if (taskName === 'task:run') {
+      const { input, ...restArgs } = args as { input?: string }
+
+      // If --input is provided, parse it as JSON and use that
+      // Otherwise, use the regular arguments spread from minimist
+      const taskArgs = input ? JSON.parse(input) : restArgs
+
       result = await task.run({
         descriptorName: action,
-        args
+        args: taskArgs
       })
     } else if (taskName === 'fixture:download') {
       const { uuid } = args as { uuid: string }
@@ -158,6 +169,12 @@ runner.setHandler(async (data: ParsedArgs): Promise<unknown> => {
       result = await task.run({
         profileName: action
       })
+    } else if (taskName === 'docs:download') {
+      const { path } = args as { path?: string }
+
+      result = await task.run({
+        path
+      })
     } else {
       result = await task.run(args)
 

package/src/tasks/docs/download.ts

@@ -0,0 +1,87 @@
+// TASK: download
+// Run this task with:
+// forge task:run docs:download
+// forge task:run docs:download --path="custom/path/forge.md"
+
+import { createTask } from '@forgehive/task'
+import { Schema } from '@forgehive/schema'
+import path from 'path'
+
+const name = 'docs:download'
+const description = 'Download the ForgeHive LLM guide from GitHub to local project'
+
+const LLM_GUIDE_URL = 'https://raw.githubusercontent.com/forge-and-hive/forge-mono-repo/refs/heads/main/docs/llm.md'
+
+const schema = new Schema({
+  path: Schema.string().optional()
+})
+
+const boundaries = {
+  fetchFile: async (url: string): Promise<string> => {
+    const response = await fetch(url)
+    if (!response.ok) {
+      throw new Error(`Failed to fetch file: ${response.status} ${response.statusText}`)
+    }
+    return await response.text()
+  },
+  getCurrentWorkingDirectory: async (): Promise<string> => {
+    return process.cwd()
+  },
+  createDirectory: async (dirPath: string): Promise<void> => {
+    const fs = await import('fs/promises')
+    await fs.mkdir(dirPath, { recursive: true })
+  },
+  writeFile: async (filePath: string, content: string): Promise<void> => {
+    const fs = await import('fs/promises')
+    await fs.writeFile(filePath, content, 'utf-8')
+  },
+  checkFileExists: async (filePath: string): Promise<boolean> => {
+    const fs = await import('fs/promises')
+    try {
+      await fs.access(filePath)
+      return true
+    } catch {
+      return false
+    }
+  }
+}
+
+export const download = createTask({
+  name,
+  description,
+  schema,
+  boundaries,
+  fn: async function ({ path: customPath }, { fetchFile, getCurrentWorkingDirectory, createDirectory, writeFile, checkFileExists }) {
+    // Determine the target path
+    const targetPath = customPath || 'docs/forge.md'
+    const cwd = await getCurrentWorkingDirectory()
+    const fullPath = path.resolve(cwd, targetPath)
+    const dirPath = path.dirname(fullPath)
+
+    console.log(`Downloading ForgeHive LLM guide to: ${targetPath}`)
+
+    // Check if file already exists
+    const fileExists = await checkFileExists(fullPath)
+    if (fileExists) {
+      console.log(`Warning: File already exists at ${targetPath}. It will be overwritten.`)
+    }
+
+    // Download the file content
+    const content = await fetchFile(LLM_GUIDE_URL)
+
+    // Create directory if it doesn't exist
+    await createDirectory(dirPath)
+
+    // Write the file
+    await writeFile(fullPath, content)
+
+    console.log(`✅ Successfully downloaded ForgeHive LLM guide to ${targetPath}`)
+
+    return {
+      success: true,
+      filePath: fullPath,
+      targetPath,
+      size: content.length
+    }
+  }
+})