@forgehive/forge-cli 0.3.13 → 0.3.14

package/dist/runner.js

@@ -163,9 +163,10 @@ runner.setHandler(async (data) => {
             });
         }
         else if (taskName === 'docs:download') {
-            const { path } = args;
+            const { path, logs } = args;
             result = await task.run({
-                path
+                path,
+                logs
             });
         }
         else if (taskName === 'project:create') {

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

@@ -1,5 +1,6 @@
 export declare const download: import("@forgehive/task").TaskInstanceType<(argv: {
     path?: string | undefined;
+    logs?: boolean | undefined;
 }, boundaries: import("@forgehive/task").WrappedBoundaries<{
     fetchFile: (url: string) => Promise<string>;
     getCurrentWorkingDirectory: () => Promise<string>;
@@ -8,9 +9,13 @@ export declare const download: import("@forgehive/task").TaskInstanceType<(argv:
     checkFileExists: (filePath: string) => Promise<boolean>;
 }>) => Promise<{
     success: boolean;
-    filePath: string;
-    targetPath: string;
-    size: number;
+    downloads: {
+        type: string;
+        filePath: string;
+        targetPath: string;
+        size: number;
+    }[];
+    totalFiles: number;
 }>, {
     fetchFile: (url: string) => Promise<string>;
     getCurrentWorkingDirectory: () => Promise<string>;

package/dist/tasks/docs/download.js

@@ -3,6 +3,8 @@
 // Run this task with:
 // forge task:run docs:download
 // forge task:run docs:download --path="custom/path/forge.md"
+// forge task:run docs:download --logs
+// forge task:run docs:download --logs --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);
@@ -45,10 +47,12 @@ 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 description = 'Download ForgeHive LLM guides 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 LLM_HIVE_LOGGING_URL = 'https://raw.githubusercontent.com/forge-and-hive/forge-mono-repo/refs/heads/main/docs/llm-hive-logging.md';
 const schema = new schema_1.Schema({
-    path: schema_1.Schema.string().optional()
+    path: schema_1.Schema.string().optional(),
+    logs: schema_1.Schema.boolean().optional()
 });
 const boundaries = {
     fetchFile: async (url) => {
@@ -85,30 +89,63 @@ exports.download = (0, task_1.createTask)({
     description,
     schema,
     boundaries,
-    fn: async function ({ path: customPath }, { fetchFile, getCurrentWorkingDirectory, createDirectory, writeFile, checkFileExists }) {
-        // Determine the target path
-        const targetPath = customPath || 'docs/forge.md';
+    fn: async function ({ path: customPath, logs }, { fetchFile, getCurrentWorkingDirectory, createDirectory, writeFile, checkFileExists }) {
         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}`);
+        const results = [];
+        // Download main LLM guide
+        const mainTargetPath = customPath || 'docs/forge.md';
+        const mainFullPath = path_1.default.resolve(cwd, mainTargetPath);
+        const mainDirPath = path_1.default.dirname(mainFullPath);
+        console.log(`Downloading ForgeHive LLM guide to: ${mainTargetPath}`);
         // Check if file already exists
-        const fileExists = await checkFileExists(fullPath);
-        if (fileExists) {
-            console.log(`Warning: File already exists at ${targetPath}. It will be overwritten.`);
+        const mainFileExists = await checkFileExists(mainFullPath);
+        if (mainFileExists) {
+            console.log(`Warning: File already exists at ${mainTargetPath}. It will be overwritten.`);
         }
-        // Download the file content
-        const content = await fetchFile(LLM_GUIDE_URL);
+        // Download the main guide content
+        const mainContent = 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}`);
+        await createDirectory(mainDirPath);
+        // Write the main guide file
+        await writeFile(mainFullPath, mainContent);
+        console.log(`✅ Successfully downloaded ForgeHive LLM guide to ${mainTargetPath}`);
+        results.push({
+            type: 'main',
+            filePath: mainFullPath,
+            targetPath: mainTargetPath,
+            size: mainContent.length
+        });
+        // Download Hive logging guide if --logs flag is provided
+        if (logs) {
+            const logsTargetPath = customPath
+                ? path_1.default.join(path_1.default.dirname(customPath), 'hive-logging.md')
+                : 'docs/hive-logging.md';
+            const logsFullPath = path_1.default.resolve(cwd, logsTargetPath);
+            const logsDirPath = path_1.default.dirname(logsFullPath);
+            console.log(`Downloading Hive Logging guide to: ${logsTargetPath}`);
+            // Check if logs file already exists
+            const logsFileExists = await checkFileExists(logsFullPath);
+            if (logsFileExists) {
+                console.log(`Warning: File already exists at ${logsTargetPath}. It will be overwritten.`);
+            }
+            // Download the logs guide content
+            const logsContent = await fetchFile(LLM_HIVE_LOGGING_URL);
+            // Create directory if it doesn't exist
+            await createDirectory(logsDirPath);
+            // Write the logs guide file
+            await writeFile(logsFullPath, logsContent);
+            console.log(`✅ Successfully downloaded Hive Logging guide to ${logsTargetPath}`);
+            results.push({
+                type: 'logs',
+                filePath: logsFullPath,
+                targetPath: logsTargetPath,
+                size: logsContent.length
+            });
+        }
         return {
             success: true,
-            filePath: fullPath,
-            targetPath,
-            size: content.length
+            downloads: results,
+            totalFiles: results.length
         };
     }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgehive/forge-cli",
-  "version": "0.3.13",
+  "version": "0.3.14",
   "description": "TypeScript CLI application",
   "license": "MIT",
   "main": "dist/index.js",
@@ -32,9 +32,9 @@
     "uuid": "^11.1.0",
     "@forgehive/record-tape": "0.2.6",
     "@forgehive/hive-sdk": "0.1.4",
-    "@forgehive/task": "0.2.6",
+    "@forgehive/schema": "0.1.4",
     "@forgehive/runner": "0.2.6",
-    "@forgehive/schema": "0.1.4"
+    "@forgehive/task": "0.2.6"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",

package/src/runner.ts

@@ -184,10 +184,11 @@ runner.setHandler(async (data: ParsedArgs): Promise<unknown> => {
         profileName: String(action)
       })
     } else if (taskName === 'docs:download') {
-      const { path } = args as { path?: string }
+      const { path, logs } = args as { path?: string, logs?: boolean }
 
       result = await task.run({
-        path
+        path,
+        logs
       })
     } else if (taskName === 'project:create') {
       const { projectName, description } = args as { projectName?: string, description?: string }

package/src/tasks/docs/download.ts

@@ -2,18 +2,22 @@
 // Run this task with:
 // forge task:run docs:download
 // forge task:run docs:download --path="custom/path/forge.md"
+// forge task:run docs:download --logs
+// forge task:run docs:download --logs --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 description = 'Download ForgeHive LLM guides 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 LLM_HIVE_LOGGING_URL = 'https://raw.githubusercontent.com/forge-and-hive/forge-mono-repo/refs/heads/main/docs/llm-hive-logging.md'
 
 const schema = new Schema({
-  path: Schema.string().optional()
+  path: Schema.string().optional(),
+  logs: Schema.boolean().optional()
 })
 
 const boundaries = {
@@ -51,37 +55,80 @@ export const download = createTask({
   description,
   schema,
   boundaries,
-  fn: async function ({ path: customPath }, { fetchFile, getCurrentWorkingDirectory, createDirectory, writeFile, checkFileExists }) {
-    // Determine the target path
-    const targetPath = customPath || 'docs/forge.md'
+  fn: async function ({ path: customPath, logs }, { fetchFile, getCurrentWorkingDirectory, createDirectory, writeFile, checkFileExists }) {
     const cwd = await getCurrentWorkingDirectory()
-    const fullPath = path.resolve(cwd, targetPath)
-    const dirPath = path.dirname(fullPath)
+    const results = []
 
-    console.log(`Downloading ForgeHive LLM guide to: ${targetPath}`)
+    // Download main LLM guide
+    const mainTargetPath = customPath || 'docs/forge.md'
+    const mainFullPath = path.resolve(cwd, mainTargetPath)
+    const mainDirPath = path.dirname(mainFullPath)
+
+    console.log(`Downloading ForgeHive LLM guide to: ${mainTargetPath}`)
 
     // Check if file already exists
-    const fileExists = await checkFileExists(fullPath)
-    if (fileExists) {
-      console.log(`Warning: File already exists at ${targetPath}. It will be overwritten.`)
+    const mainFileExists = await checkFileExists(mainFullPath)
+    if (mainFileExists) {
+      console.log(`Warning: File already exists at ${mainTargetPath}. It will be overwritten.`)
     }
 
-    // Download the file content
-    const content = await fetchFile(LLM_GUIDE_URL)
+    // Download the main guide content
+    const mainContent = await fetchFile(LLM_GUIDE_URL)
 
     // Create directory if it doesn't exist
-    await createDirectory(dirPath)
+    await createDirectory(mainDirPath)
+
+    // Write the main guide file
+    await writeFile(mainFullPath, mainContent)
+
+    console.log(`✅ Successfully downloaded ForgeHive LLM guide to ${mainTargetPath}`)
+
+    results.push({
+      type: 'main',
+      filePath: mainFullPath,
+      targetPath: mainTargetPath,
+      size: mainContent.length
+    })
+
+    // Download Hive logging guide if --logs flag is provided
+    if (logs) {
+      const logsTargetPath = customPath
+        ? path.join(path.dirname(customPath), 'hive-logging.md')
+        : 'docs/hive-logging.md'
+      const logsFullPath = path.resolve(cwd, logsTargetPath)
+      const logsDirPath = path.dirname(logsFullPath)
+
+      console.log(`Downloading Hive Logging guide to: ${logsTargetPath}`)
 
-    // Write the file
-    await writeFile(fullPath, content)
+      // Check if logs file already exists
+      const logsFileExists = await checkFileExists(logsFullPath)
+      if (logsFileExists) {
+        console.log(`Warning: File already exists at ${logsTargetPath}. It will be overwritten.`)
+      }
 
-    console.log(`✅ Successfully downloaded ForgeHive LLM guide to ${targetPath}`)
+      // Download the logs guide content
+      const logsContent = await fetchFile(LLM_HIVE_LOGGING_URL)
+
+      // Create directory if it doesn't exist
+      await createDirectory(logsDirPath)
+
+      // Write the logs guide file
+      await writeFile(logsFullPath, logsContent)
+
+      console.log(`✅ Successfully downloaded Hive Logging guide to ${logsTargetPath}`)
+
+      results.push({
+        type: 'logs',
+        filePath: logsFullPath,
+        targetPath: logsTargetPath,
+        size: logsContent.length
+      })
+    }
 
     return {
       success: true,
-      filePath: fullPath,
-      targetPath,
-      size: content.length
+      downloads: results,
+      totalFiles: results.length
     }
   }
 })