@forgehive/forge-cli 0.3.16 → 0.3.18

package/dist/runner.js

@@ -92,7 +92,7 @@ runner.setHandler(async (data) => {
         const commandsWithDescriptor = ['task:create', 'task:remove', 'task:publish', 'task:describe', 'task:fingerprint'];
         const commandsWithRunner = ['runner:create', 'runner:remove'];
         const commandsWithoutParams = ['project:unlink', 'project:sync', 'auth:clear'];
-        const silentCommands = ['task:describe', 'task:list', 'auth:list', 'info'];
+        const silentCommands = ['task:describe', 'task:list', 'auth:list', 'info', 'docs:download'];
         if (commandsWithDescriptor.includes(taskName)) {
             result = await task.run({ descriptorName: action });
         }
@@ -170,9 +170,9 @@ runner.setHandler(async (data) => {
             });
         }
         else if (taskName === 'project:create') {
-            const { projectName, description } = args;
+            const { name, description } = args;
             result = await task.run({
-                projectName,
+                name,
                 description
             });
         }

package/dist/tasks/bundle/create.d.ts

@@ -1,6 +1,11 @@
+import { type ForgeConf } from '../types';
 export declare const create: import("@forgehive/task").TaskInstanceType<(argv: {
     entryPoint: string;
     outputFile: string;
-}, boundaries: import("@forgehive/task").WrappedBoundaries<{}>) => Promise<{
+}, boundaries: import("@forgehive/task").WrappedBoundaries<{
+    loadConf: (args: {}) => Promise<Promise<ForgeConf>>;
+}>) => Promise<{
     outputFile: string;
-}>, {}>;
+}>, {
+    loadConf: (args: {}) => Promise<Promise<ForgeConf>>;
+}>;

package/dist/tasks/bundle/create.js

@@ -10,15 +10,22 @@ exports.create = void 0;
 const task_1 = require("@forgehive/task");
 const schema_1 = require("@forgehive/schema");
 const esbuild_1 = __importDefault(require("esbuild"));
+const load_1 = require("../conf/load");
 const schema = new schema_1.Schema({
     entryPoint: schema_1.Schema.string(),
     outputFile: schema_1.Schema.string()
 });
-const boundaries = {};
+const boundaries = {
+    loadConf: load_1.load.asBoundary()
+};
 exports.create = (0, task_1.createTask)({
     schema,
     boundaries,
-    fn: async function ({ entryPoint, outputFile }) {
+    fn: async function ({ entryPoint, outputFile }, { loadConf }) {
+        // Load forge configuration
+        const forge = await loadConf({});
+        // Get external packages from config, default to empty array
+        const externalPackages = forge.build?.externalPackages ?? [];
         // Build using esbuild
         await esbuild_1.default.build({
             entryPoints: [entryPoint],
@@ -26,7 +33,8 @@ exports.create = (0, task_1.createTask)({
             bundle: true,
             minify: true,
             platform: 'node',
-            sourcemap: true
+            sourcemap: true,
+            external: externalPackages
         });
         return { outputFile };
     }

package/dist/tasks/bundle/fingerprint.js

@@ -122,6 +122,8 @@ exports.fingerprint = (0, task_1.createTask)({
         console.log(`Generating bundle with fingerprints for task: ${descriptorName}`);
         console.log(`Entry point: ${entryPoint}`);
         console.log(`Output: ${outputFile}`);
+        // Get external packages from config, default to empty array
+        const externalPackages = forgeJson.build?.externalPackages ?? [];
         // Build with fingerprinting plugin
         const result = await esbuild_1.default.build({
             entryPoints: [entryPoint],
@@ -131,7 +133,8 @@ exports.fingerprint = (0, task_1.createTask)({
             platform: 'node',
             sourcemap: true,
             plugins: [taskFingerprintPlugin()],
-            metafile: true
+            metafile: true,
+            external: externalPackages
         });
         // Extract fingerprints from build result
         const taskFingerprints = result.fingerprints || [];

package/dist/tasks/docs/download.js

@@ -117,6 +117,7 @@ exports.download = (0, task_1.createTask)({
         });
         // Download Hive logging guide if --logs flag is provided
         if (logs) {
+            console.log('===============================================');
             const logsTargetPath = customPath
                 ? path_1.default.join(path_1.default.dirname(customPath), 'hive-logging.md')
                 : 'docs/hive-logging.md';
@@ -142,6 +143,7 @@ exports.download = (0, task_1.createTask)({
                 size: logsContent.length
             });
         }
+        console.log('===============================================');
         return {
             success: true,
             downloads: results,

package/dist/tasks/project/create.d.ts

@@ -1,7 +1,7 @@
 import { type ForgeConf, type Profile } from '../types';
 export declare const create: import("@forgehive/task").TaskInstanceType<(argv: {
+    name: string;
     description?: string | undefined;
-    projectName?: string | undefined;
 }, boundaries: import("@forgehive/task").WrappedBoundaries<{
     loadConf: (args: {}) => Promise<Promise<ForgeConf>>;
     loadCurrentProfile: (args: {}) => Promise<Promise<Profile>>;

package/dist/tasks/project/create.js

@@ -14,10 +14,10 @@ const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 const load_1 = require("../conf/load");
 const loadCurrent_1 = require("../auth/loadCurrent");
-const name = 'project:create';
-const description = 'Create a new project in ForgeHive';
+const taskName = 'project:create';
+const taskDescription = 'Create a new project in ForgeHive';
 const schema = new schema_1.Schema({
-    projectName: schema_1.Schema.string().optional(),
+    name: schema_1.Schema.string(),
     description: schema_1.Schema.string().optional()
 });
 const boundaries = {
@@ -39,33 +39,29 @@ const boundaries = {
     }
 };
 exports.create = (0, task_1.createTask)({
-    name,
-    description,
+    name: taskName,
+    description: taskDescription,
     schema,
     boundaries,
     fn: async function (argv, { loadConf, loadCurrentProfile, writeFile, createProject }) {
-        const { projectName: inputProjectName, description } = argv;
+        const { name: projectName, description } = argv;
         // Load current configuration
         const conf = await loadConf({});
-        // Use provided projectName or fall back to forge.json project name
-        const projectName = inputProjectName || conf.project.name;
-        if (!projectName) {
-            throw new Error('Project name is required. Provide --projectName or ensure forge.json has a project name.');
-        }
         // Check if project already has a UUID, generate one if not
-        let projectUuid = conf.project.uuid;
-        if (!projectUuid) {
-            projectUuid = (0, uuid_1.v4)();
-            // Update forge.json with the new UUID
-            const forgePath = path_1.default.join(process.cwd(), 'forge.json');
-            const updatedConf = {
-                ...conf,
-                project: {
-                    ...conf.project,
-                    uuid: projectUuid
-                }
-            };
-            await writeFile(forgePath, JSON.stringify(updatedConf, null, 2));
+        const projectUuid = conf.project.uuid || (0, uuid_1.v4)();
+        // Update forge.json with the project name and UUID
+        const forgePath = path_1.default.join(process.cwd(), 'forge.json');
+        const updatedConf = {
+            ...conf,
+            project: {
+                ...conf.project,
+                name: projectName,
+                uuid: projectUuid
+            }
+        };
+        await writeFile(forgePath, JSON.stringify(updatedConf, null, 2));
+        console.log(`Updated forge.json with project name: ${projectName}`);
+        if (!conf.project.uuid) {
             console.log(`Generated and saved project UUID: ${projectUuid}`);
         }
         // Load current profile for API authentication

package/dist/tasks/project/sync.d.ts

@@ -4,7 +4,7 @@ export declare const sync: import("@forgehive/task").TaskInstanceType<(argv: {},
     loadCurrentProfile: (args: {}) => Promise<Promise<import("../types").Profile>>;
     getCwd: () => Promise<string>;
     persistConf: (forge: ForgeConf, cwd: string) => Promise<void>;
-    syncTasksToHive: (projectUuid: string, tasks: Array<{
+    syncTasksToHive: (projectUuid: string, projectName: string, projectDescription: string | undefined, tasks: Array<{
         uuid: string;
         name: string;
     }>, apiKey: string, apiSecret: string, baseUrl: string) => Promise<{
@@ -78,7 +78,7 @@ export declare const sync: import("@forgehive/task").TaskInstanceType<(argv: {},
     loadCurrentProfile: (args: {}) => Promise<Promise<import("../types").Profile>>;
     getCwd: () => Promise<string>;
     persistConf: (forge: ForgeConf, cwd: string) => Promise<void>;
-    syncTasksToHive: (projectUuid: string, tasks: Array<{
+    syncTasksToHive: (projectUuid: string, projectName: string, projectDescription: string | undefined, tasks: Array<{
         uuid: string;
         name: string;
     }>, apiKey: string, apiSecret: string, baseUrl: string) => Promise<{

package/dist/tasks/project/sync.js

@@ -25,7 +25,7 @@ const boundaries = {
         const forgePath = path_1.default.join(cwd, 'forge.json');
         await promises_1.default.writeFile(forgePath, JSON.stringify(forge, null, 2));
     },
-    syncTasksToHive: async (projectUuid, tasks, apiKey, apiSecret, baseUrl) => {
+    syncTasksToHive: async (projectUuid, projectName, projectDescription, tasks, apiKey, apiSecret, baseUrl) => {
         try {
             const url = `${baseUrl}/api/projects/${projectUuid}/sync`;
             const response = await fetch(url, {
@@ -34,7 +34,7 @@ const boundaries = {
                     'Content-Type': 'application/json',
                     'Authorization': `Bearer ${apiKey}:${apiSecret}`
                 },
-                body: JSON.stringify({ tasks })
+                body: JSON.stringify({ projectName, description: projectDescription, tasks })
             });
             if (response.ok) {
                 const data = await response.json();
@@ -96,9 +96,13 @@ exports.sync = (0, task_1.createTask)({
             return { status: 'no-tasks', message: 'No tasks found in project' };
         }
         console.log(`  📊 Found ${tasksToSync.length} tasks to sync`);
+        console.log(`  📝 Project name: ${forge.project.name}`);
+        if (forge.project.description) {
+            console.log(`  📝 Project description: ${forge.project.description}`);
+        }
         try {
             const profile = await loadCurrentProfile({});
-            const result = await syncTasksToHive(forge.project.uuid, tasksToSync, profile.apiKey, profile.apiSecret, profile.url);
+            const result = await syncTasksToHive(forge.project.uuid, forge.project.name, forge.project.description, tasksToSync, profile.apiKey, profile.apiSecret, profile.url);
             if (result.success && result.data) {
                 const { summary, results } = result.data;
                 console.log('\\n  ✅ Sync completed successfully!');

package/dist/tasks/runner/bundle.js

@@ -56,6 +56,8 @@ exports.bundle = (0, task_1.createTask)({
     `);
         // Ensure target directory exists
         await ensureDir(path_1.default.dirname(targetPath));
+        // Get external packages from config, default to empty array
+        const externalPackages = forge.build?.externalPackages ?? [];
         // Build using esbuild
         await esbuild_1.default.build({
             entryPoints: [entryPoint],
@@ -63,7 +65,8 @@ exports.bundle = (0, task_1.createTask)({
             bundle: true,
             minify: true,
             platform: 'node',
-            sourcemap: true
+            sourcemap: true,
+            external: externalPackages
         });
         return {
             status: 'Success',

package/dist/tasks/task/replay.d.ts

@@ -1,3 +1,4 @@
+import { type ExecutionRecord } from '@forgehive/hive-sdk';
 import { type ForgeConf, type Profile } from '../types';
 interface Fixture {
     fixtureUUID: string;
@@ -28,7 +29,10 @@ export declare const replay: import("@forgehive/task").TaskInstanceType<(argv: {
     }) => Promise<Promise<any>>;
     ensureBuildsFolder: () => Promise<string>;
     verifyLogFolder: (logsPath: string) => Promise<boolean>;
-    sendLogToAPI: (profile: Profile, projectName: string, taskName: string, logItem: unknown, fixtureUUID: string) => Promise<boolean>;
+    sendLogToAPI: (profile: Profile, record: ExecutionRecord, fixtureUUID: string) => Promise<{
+        success: boolean;
+        logUuid?: string;
+    }>;
 }>) => Promise<any>, {
     readFixture: (filePath: string) => Promise<Fixture>;
     loadConf: (args: {}) => Promise<Promise<ForgeConf>>;
@@ -44,6 +48,9 @@ export declare const replay: import("@forgehive/task").TaskInstanceType<(argv: {
     }) => Promise<Promise<any>>;
     ensureBuildsFolder: () => Promise<string>;
     verifyLogFolder: (logsPath: string) => Promise<boolean>;
-    sendLogToAPI: (profile: Profile, projectName: string, taskName: string, logItem: unknown, fixtureUUID: string) => Promise<boolean>;
+    sendLogToAPI: (profile: Profile, record: ExecutionRecord, fixtureUUID: string) => Promise<{
+        success: boolean;
+        logUuid?: string;
+    }>;
 }>;
 export {};

package/dist/tasks/task/replay.js

@@ -12,7 +12,7 @@ const schema_1 = require("@forgehive/schema");
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
-const axios_1 = __importDefault(require("axios"));
+const hive_sdk_1 = require("@forgehive/hive-sdk");
 const create_1 = require("../bundle/create");
 const load_1 = require("../bundle/load");
 const load_2 = require("../conf/load");
@@ -53,30 +53,41 @@ const boundaries = {
         }
         return true;
     },
-    sendLogToAPI: async (profile, projectName, taskName, logItem, fixtureUUID) => {
+    sendLogToAPI: async (profile, record, fixtureUUID) => {
         try {
-            const logsUrl = `${profile.url}/api/tasks/log-ingest`;
-            const authToken = `${profile.apiKey}:${profile.apiSecret}`;
-            await axios_1.default.post(logsUrl, {
-                projectName,
-                taskName,
-                logItem: JSON.stringify(logItem),
-                replayFrom: fixtureUUID
-            }, {
-                headers: {
-                    Authorization: `Bearer ${authToken}`,
-                    'Content-Type': 'application/json'
+            // Use createClientFromForgeConf to automatically load forge.json with task UUIDs
+            const client = (0, hive_sdk_1.createClientFromForgeConf)('./forge.json', {
+                apiKey: profile.apiKey,
+                apiSecret: profile.apiSecret,
+                host: profile.url,
+                metadata: {
+                    environment: 'cli',
+                    replayFrom: fixtureUUID
                 }
             });
             console.log('===============================================');
-            console.log('Log sent to API... ', profile.name, profile.url);
-            console.log('Replay from fixture UUID:', fixtureUUID);
-            return true;
+            console.log('Sending replay log to Hive...');
+            const result = await client.sendLog(record);
+            if (result === 'success' || (typeof result === 'object' && 'uuid' in result)) {
+                console.log('✅ Log sent to API...', profile.name, profile.url);
+                console.log('Replay from fixture UUID:', fixtureUUID);
+                console.log('===============================================');
+                if (typeof result === 'object' && result && 'uuid' in result) {
+                    return { success: true, logUuid: result.uuid };
+                }
+                return { success: true };
+            }
+            else {
+                console.error('❌ Failed to send log to Hive');
+                console.log('===============================================');
+                return { success: false };
+            }
         }
         catch (e) {
             const error = e;
-            console.error('Failed to send log to API:', error.message);
-            return false;
+            console.error('❌ Failed to send log to API:', error.message);
+            console.log('===============================================');
+            return { success: false };
         }
     }
 };
@@ -90,7 +101,6 @@ exports.replay = (0, task_1.createTask)({
         // Load forge configuration
         const forge = await loadConf({});
         const taskDescriptor = forge.tasks[descriptorName];
-        const projectName = forge.project.name;
         if (taskDescriptor === undefined) {
             throw new Error(`Task ${descriptorName} is not defined in forge.json`);
         }
@@ -168,7 +178,7 @@ exports.replay = (0, task_1.createTask)({
         // Send the log to API if profile is available
         if (profile) {
             try {
-                await sendLogToAPI(profile, projectName, descriptorName, record, fixture.fixtureUUID);
+                await sendLogToAPI(profile, record, fixture.fixtureUUID);
             }
             catch (e) {
                 console.error('Failed to send log to API:', e);

package/dist/tasks/task/run.d.ts

@@ -17,7 +17,7 @@ export declare const run: import("@forgehive/task").TaskInstanceType<(argv: {
     }) => Promise<Promise<any>>;
     ensureLogFolder: (logsPath: string) => Promise<void>;
     ensureBuildsFolder: () => Promise<string>;
-    sendLogToAPI: (profile: Profile, projectName: string, record: ExecutionRecord, taskUuid?: string, projectUuid?: string) => Promise<{
+    sendLogToAPI: (profile: Profile, record: ExecutionRecord, taskUuid?: string) => Promise<{
         success: boolean;
         logUuid?: string;
         taskUuid?: string;
@@ -37,7 +37,7 @@ export declare const run: import("@forgehive/task").TaskInstanceType<(argv: {
     }) => Promise<Promise<any>>;
     ensureLogFolder: (logsPath: string) => Promise<void>;
     ensureBuildsFolder: () => Promise<string>;
-    sendLogToAPI: (profile: Profile, projectName: string, record: ExecutionRecord, taskUuid?: string, projectUuid?: string) => Promise<{
+    sendLogToAPI: (profile: Profile, record: ExecutionRecord, taskUuid?: string) => Promise<{
         success: boolean;
         logUuid?: string;
         taskUuid?: string;

package/dist/tasks/task/run.js

@@ -50,39 +50,32 @@ const boundaries = {
         }
         return buildsPath;
     },
-    sendLogToAPI: async (profile, projectName, record, taskUuid, projectUuid) => {
-        // Check if we have required UUIDs for the new endpoint
-        if (!projectUuid || !taskUuid) {
+    sendLogToAPI: async (profile, record, taskUuid) => {
+        // Check if we have required UUID for the task
+        if (!taskUuid) {
             console.log('===============================================');
-            console.log('⚠️  Remote logging skipped - missing UUIDs');
+            console.log('⚠️  Remote logging skipped - missing task UUID');
             console.log('');
             console.log('To enable remote logging with enhanced features:');
-            if (!projectUuid) {
-                console.log('• Use "forge project:create" to create a new project, or');
-                console.log('• Use "forge project:link" to connect to an existing project');
-            }
-            if (!taskUuid) {
-                console.log('• Use "forge project:sync" to get the task to have UUID');
-            }
+            console.log('• Use "forge project:sync" to sync tasks and get UUIDs');
             console.log('===============================================');
             return { success: true, skipRemoteLog: true };
         }
         try {
-            const config = {
-                projectName,
-                projectUuid,
+            // Use createClientFromForgeConf to automatically load forge.json with task UUIDs
+            const client = (0, hive_sdk_1.createClientFromForgeConf)('./forge.json', {
                 apiKey: profile.apiKey,
                 apiSecret: profile.apiSecret,
                 host: profile.url,
                 metadata: {
                     environment: 'cli'
                 }
-            };
-            const client = new hive_sdk_1.HiveLogClient(config);
+            });
+            console.log('===============================================');
             console.log('Sending execution log to Hive...');
-            const result = await client.sendLogByUuid(record, taskUuid);
+            const result = await client.sendLog(record);
             if (result === 'success' || (typeof result === 'object' && 'uuid' in result)) {
-                console.log('===============================================');
+                console.log('');
                 console.log('✅ Log sent to Hive successfully');
                 console.log(`   Profile: ${profile.name}`);
                 console.log(`   Host: ${profile.url}`);
@@ -93,14 +86,18 @@ const boundaries = {
                 return { success: true, taskUuid };
             }
             else {
+                console.log('');
                 console.error('❌ Failed to send log to Hive:', profile.url);
+                console.log('===============================================');
                 return { success: false };
             }
         }
         catch (e) {
+            console.log('===============================================');
             console.error('❌ Failed to send log to Hive:', profile.url);
             const error = e;
             console.error('Error:', error.message);
+            console.log('===============================================');
             return { success: false };
         }
     }
@@ -112,8 +109,6 @@ exports.run = (0, task_1.createTask)({
         // Load forge configuration
         const forge = await loadConf({});
         const taskDescriptor = forge.tasks[descriptorName];
-        const projectName = forge.project.name;
-        const projectUuid = forge.project.uuid;
         const taskUuid = taskDescriptor?.uuid;
         if (taskDescriptor === undefined) {
             throw new Error('Task is not defined on forge.json');
@@ -175,7 +170,7 @@ exports.run = (0, task_1.createTask)({
         await tape.save();
         if (profile) {
             try {
-                const logResult = await sendLogToAPI(profile, projectName, logItem, taskUuid, projectUuid);
+                const logResult = await sendLogToAPI(profile, logItem, taskUuid);
                 if (logResult.success && !logResult.skipRemoteLog && taskUuid) {
                     console.log(`🔗 View execution logs: ${profile.url}/tasks/${taskUuid}?tab=logs`);
                 }

package/dist/tasks/types.d.ts

@@ -19,6 +19,7 @@ export interface ForgeConf {
     project: {
         name: string;
         uuid?: string;
+        description?: string;
     };
     paths: {
         logs: string;
@@ -31,6 +32,9 @@ export interface ForgeConf {
     infra: Infra;
     tasks: Record<string, TaskDescriptor>;
     runners: Record<string, RunnerDescriptor>;
+    build?: {
+        externalPackages?: string[];
+    };
 }
 export interface TaskName {
     descriptor: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgehive/forge-cli",
-  "version": "0.3.16",
+  "version": "0.3.18",
   "description": "TypeScript CLI application",
   "license": "MIT",
   "main": "dist/index.js",
@@ -10,7 +10,7 @@
   "publishConfig": {
     "access": "public",
     "dependencies": {
-      "@forgehive/hive-sdk": "^0.1.6",
+      "@forgehive/hive-sdk": "^0.2.0",
       "@forgehive/record-tape": "^0.2.7",
       "@forgehive/runner": "^0.2.7",
       "@forgehive/schema": "^0.1.4",
@@ -30,11 +30,11 @@
     "minimist": "^1.2.8",
     "typescript": "^5.3.3",
     "uuid": "^11.1.0",
-    "@forgehive/schema": "0.1.4",
+    "@forgehive/record-tape": "0.2.7",
     "@forgehive/task": "0.2.7",
-    "@forgehive/hive-sdk": "0.1.6",
-    "@forgehive/runner": "0.2.7",
-    "@forgehive/record-tape": "0.2.7"
+    "@forgehive/hive-sdk": "0.2.0",
+    "@forgehive/schema": "0.1.4",
+    "@forgehive/runner": "0.2.7"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",

package/src/runner.ts

@@ -114,7 +114,7 @@ runner.setHandler(async (data: ParsedArgs): Promise<unknown> => {
     const commandsWithDescriptor = ['task:create', 'task:remove', 'task:publish', 'task:describe', 'task:fingerprint']
     const commandsWithRunner = ['runner:create', 'runner:remove']
     const commandsWithoutParams = ['project:unlink', 'project:sync', 'auth:clear']
-    const silentCommands = ['task:describe', 'task:list', 'auth:list', 'info']
+    const silentCommands = ['task:describe', 'task:list', 'auth:list', 'info', 'docs:download']
 
     if (commandsWithDescriptor.includes(taskName)) {
       result = await task.run({ descriptorName: action })
@@ -191,10 +191,10 @@ runner.setHandler(async (data: ParsedArgs): Promise<unknown> => {
         logs
       })
     } else if (taskName === 'project:create') {
-      const { projectName, description } = args as { projectName?: string, description?: string }
+      const { name, description } = args as { name: string, description?: string }
 
       result = await task.run({
-        projectName,
+        name,
         description
       })
     } else if (taskName === 'project:link') {

package/src/tasks/bundle/create.ts

@@ -5,18 +5,28 @@
 import { createTask } from '@forgehive/task'
 import { Schema } from '@forgehive/schema'
 import esbuild from 'esbuild'
+import { load as loadConf } from '../conf/load'
+import { type ForgeConf } from '../types'
 
 const schema = new Schema({
   entryPoint: Schema.string(),
   outputFile: Schema.string()
 })
 
-const boundaries = {}
+const boundaries = {
+  loadConf: loadConf.asBoundary()
+}
 
 export const create = createTask({
   schema,
   boundaries,
-  fn: async function ({ entryPoint, outputFile }) {
+  fn: async function ({ entryPoint, outputFile }, { loadConf }) {
+    // Load forge configuration
+    const forge: ForgeConf = await loadConf({})
+
+    // Get external packages from config, default to empty array
+    const externalPackages = forge.build?.externalPackages ?? []
+
     // Build using esbuild
     await esbuild.build({
       entryPoints: [entryPoint],
@@ -24,7 +34,8 @@ export const create = createTask({
       bundle: true,
       minify: true,
       platform: 'node',
-      sourcemap: true
+      sourcemap: true,
+      external: externalPackages
     })
 
     return { outputFile }

package/src/tasks/bundle/fingerprint.ts

@@ -174,6 +174,9 @@ export const fingerprint = createTask({
     console.log(`Entry point: ${entryPoint}`)
     console.log(`Output: ${outputFile}`)
 
+    // Get external packages from config, default to empty array
+    const externalPackages = forgeJson.build?.externalPackages ?? []
+
     // Build with fingerprinting plugin
     const result = await esbuild.build({
       entryPoints: [entryPoint],
@@ -183,7 +186,8 @@ export const fingerprint = createTask({
       platform: 'node',
       sourcemap: true,
       plugins: [taskFingerprintPlugin()],
-      metafile: true
+      metafile: true,
+      external: externalPackages
     })
 
     // Extract fingerprints from build result

package/src/tasks/docs/download.ts

@@ -92,6 +92,7 @@ export const download = createTask({
 
     // Download Hive logging guide if --logs flag is provided
     if (logs) {
+      console.log('===============================================')
       const logsTargetPath = customPath
         ? path.join(path.dirname(customPath), 'hive-logging.md')
         : 'docs/hive-logging.md'
@@ -125,6 +126,8 @@ export const download = createTask({
       })
     }
 
+    console.log('===============================================')
+
     return {
       success: true,
       downloads: results,

package/src/tasks/project/create.ts

@@ -12,11 +12,11 @@ import { load as loadConf } from '../conf/load'
 import { loadCurrent as loadCurrentProfile } from '../auth/loadCurrent'
 import { type ForgeConf, type Profile } from '../types'
 
-const name = 'project:create'
-const description = 'Create a new project in ForgeHive'
+const taskName = 'project:create'
+const taskDescription = 'Create a new project in ForgeHive'
 
 const schema = new Schema({
-  projectName: Schema.string().optional(),
+  name: Schema.string(),
   description: Schema.string().optional()
 })
 
@@ -40,39 +40,33 @@ const boundaries = {
 }
 
 export const create = createTask({
-  name,
-  description,
+  name: taskName,
+  description: taskDescription,
   schema,
   boundaries,
   fn: async function (argv, { loadConf, loadCurrentProfile, writeFile, createProject }) {
-    const { projectName: inputProjectName, description } = argv
+    const { name: projectName, description } = argv
 
     // Load current configuration
     const conf = await loadConf({})
 
-    // Use provided projectName or fall back to forge.json project name
-    const projectName = inputProjectName || conf.project.name
-
-    if (!projectName) {
-      throw new Error('Project name is required. Provide --projectName or ensure forge.json has a project name.')
-    }
-
     // Check if project already has a UUID, generate one if not
-    let projectUuid = conf.project.uuid
-    if (!projectUuid) {
-      projectUuid = uuidv4()
-
-      // Update forge.json with the new UUID
-      const forgePath = path.join(process.cwd(), 'forge.json')
-      const updatedConf: ForgeConf = {
-        ...conf,
-        project: {
-          ...conf.project,
-          uuid: projectUuid
-        }
+    const projectUuid = conf.project.uuid || uuidv4()
+
+    // Update forge.json with the project name and UUID
+    const forgePath = path.join(process.cwd(), 'forge.json')
+    const updatedConf: ForgeConf = {
+      ...conf,
+      project: {
+        ...conf.project,
+        name: projectName,
+        uuid: projectUuid
       }
+    }
 
-      await writeFile(forgePath, JSON.stringify(updatedConf, null, 2))
+    await writeFile(forgePath, JSON.stringify(updatedConf, null, 2))
+    console.log(`Updated forge.json with project name: ${projectName}`)
+    if (!conf.project.uuid) {
       console.log(`Generated and saved project UUID: ${projectUuid}`)
     }
 

package/src/tasks/project/sync.ts

@@ -26,6 +26,8 @@ const boundaries = {
   },
   syncTasksToHive: async (
     projectUuid: string,
+    projectName: string,
+    projectDescription: string | undefined,
     tasks: Array<{ uuid: string; name: string }>,
     apiKey: string,
     apiSecret: string,
@@ -57,7 +59,7 @@ const boundaries = {
           'Content-Type': 'application/json',
           'Authorization': `Bearer ${apiKey}:${apiSecret}`
         },
-        body: JSON.stringify({ tasks })
+        body: JSON.stringify({ projectName, description: projectDescription, tasks })
       })
 
       if (response.ok) {
@@ -134,11 +136,17 @@ export const sync = createTask({
     }
 
     console.log(`  📊 Found ${tasksToSync.length} tasks to sync`)
+    console.log(`  📝 Project name: ${forge.project.name}`)
+    if (forge.project.description) {
+      console.log(`  📝 Project description: ${forge.project.description}`)
+    }
 
     try {
       const profile = await loadCurrentProfile({})
       const result = await syncTasksToHive(
         forge.project.uuid,
+        forge.project.name,
+        forge.project.description,
         tasksToSync,
         profile.apiKey,
         profile.apiSecret,

package/src/tasks/runner/bundle.ts

@@ -59,6 +59,9 @@ export const bundle = createTask({
     // Ensure target directory exists
     await ensureDir(path.dirname(targetPath))
 
+    // Get external packages from config, default to empty array
+    const externalPackages = forge.build?.externalPackages ?? []
+
     // Build using esbuild
     await esbuild.build({
       entryPoints: [entryPoint],
@@ -66,7 +69,8 @@ export const bundle = createTask({
       bundle: true,
       minify: true,
       platform: 'node',
-      sourcemap: true
+      sourcemap: true,
+      external: externalPackages
     })
 
     return {

package/src/tasks/task/replay.ts

@@ -7,8 +7,8 @@ import { Schema } from '@forgehive/schema'
 import fs from 'fs/promises'
 import path from 'path'
 import os from 'os'
-import axios from 'axios'
 
+import { createClientFromForgeConf, type ExecutionRecord } from '@forgehive/hive-sdk'
 import { create as bundleCreate } from '../bundle/create'
 import { load as bundleLoad } from '../bundle/load'
 import { load as loadConf } from '../conf/load'
@@ -66,32 +66,47 @@ const boundaries = {
 
     return true
   },
-  sendLogToAPI: async (profile: Profile, projectName: string, taskName: string, logItem: unknown, fixtureUUID: string): Promise<boolean> => {
+  sendLogToAPI: async (
+    profile: Profile,
+    record: ExecutionRecord,
+    fixtureUUID: string
+  ): Promise<{ success: boolean; logUuid?: string }> => {
     try {
-      const logsUrl = `${profile.url}/api/tasks/log-ingest`
-      const authToken = `${profile.apiKey}:${profile.apiSecret}`
-
-      await axios.post(logsUrl, {
-        projectName,
-        taskName,
-        logItem: JSON.stringify(logItem),
-        replayFrom: fixtureUUID
-      }, {
-        headers: {
-          Authorization: `Bearer ${authToken}`,
-          'Content-Type': 'application/json'
+      // Use createClientFromForgeConf to automatically load forge.json with task UUIDs
+      const client = createClientFromForgeConf('./forge.json', {
+        apiKey: profile.apiKey,
+        apiSecret: profile.apiSecret,
+        host: profile.url,
+        metadata: {
+          environment: 'cli',
+          replayFrom: fixtureUUID
         }
       })
 
       console.log('===============================================')
-      console.log('Log sent to API... ', profile.name, profile.url)
-      console.log('Replay from fixture UUID:', fixtureUUID)
+      console.log('Sending replay log to Hive...')
+      const result = await client.sendLog(record)
 
-      return true
+      if (result === 'success' || (typeof result === 'object' && 'uuid' in result)) {
+        console.log('✅ Log sent to API...', profile.name, profile.url)
+        console.log('Replay from fixture UUID:', fixtureUUID)
+        console.log('===============================================')
+
+        if (typeof result === 'object' && result && 'uuid' in result) {
+          return { success: true, logUuid: result.uuid }
+        }
+
+        return { success: true }
+      } else {
+        console.error('❌ Failed to send log to Hive')
+        console.log('===============================================')
+        return { success: false }
+      }
     } catch (e) {
       const error = e as Error
-      console.error('Failed to send log to API:', error.message)
-      return false
+      console.error('❌ Failed to send log to API:', error.message)
+      console.log('===============================================')
+      return { success: false }
     }
   }
 }
@@ -107,7 +122,6 @@ export const replay = createTask({
     // Load forge configuration
     const forge: ForgeConf = await loadConf({})
     const taskDescriptor = forge.tasks[descriptorName as keyof typeof forge.tasks]
-    const projectName = forge.project.name
 
     if (taskDescriptor === undefined) {
       throw new Error(`Task ${descriptorName} is not defined in forge.json`)
@@ -203,7 +217,7 @@ export const replay = createTask({
     // Send the log to API if profile is available
     if (profile) {
       try {
-        await sendLogToAPI(profile, projectName, descriptorName, record, fixture.fixtureUUID)
+        await sendLogToAPI(profile, record, fixture.fixtureUUID)
       } catch (e) {
         console.error('Failed to send log to API:', e)
       }

package/src/tasks/task/run.ts

@@ -10,7 +10,7 @@ import os from 'os'
 import { createTask } from '@forgehive/task'
 import { Schema } from '@forgehive/schema'
 import { RecordTape } from '@forgehive/record-tape'
-import { HiveLogClient, type ExecutionRecord } from '@forgehive/hive-sdk'
+import { createClientFromForgeConf, type ExecutionRecord } from '@forgehive/hive-sdk'
 
 import { create as bundleCreate } from '../bundle/create'
 import { load as bundleLoad } from '../bundle/load'
@@ -51,46 +51,37 @@ const boundaries = {
   },
   sendLogToAPI: async (
     profile: Profile,
-    projectName: string,
     record: ExecutionRecord,
-    taskUuid?: string,
-    projectUuid?: string
+    taskUuid?: string
   ): Promise<{ success: boolean; logUuid?: string; taskUuid?: string; skipRemoteLog?: boolean }> => {
-    // Check if we have required UUIDs for the new endpoint
-    if (!projectUuid || !taskUuid) {
+    // Check if we have required UUID for the task
+    if (!taskUuid) {
       console.log('===============================================')
-      console.log('⚠️  Remote logging skipped - missing UUIDs')
+      console.log('⚠️  Remote logging skipped - missing task UUID')
       console.log('')
       console.log('To enable remote logging with enhanced features:')
-      if (!projectUuid) {
-        console.log('• Use "forge project:create" to create a new project, or')
-        console.log('• Use "forge project:link" to connect to an existing project')
-      }
-      if (!taskUuid) {
-        console.log('• Use "forge project:sync" to get the task to have UUID')
-      }
+      console.log('• Use "forge project:sync" to sync tasks and get UUIDs')
       console.log('===============================================')
       return { success: true, skipRemoteLog: true }
     }
 
     try {
-      const config = {
-        projectName,
-        projectUuid,
+      // Use createClientFromForgeConf to automatically load forge.json with task UUIDs
+      const client = createClientFromForgeConf('./forge.json', {
         apiKey: profile.apiKey,
         apiSecret: profile.apiSecret,
         host: profile.url,
         metadata: {
           environment: 'cli'
         }
-      }
+      })
 
-      const client = new HiveLogClient(config)
+      console.log('===============================================')
       console.log('Sending execution log to Hive...')
-      const result = await client.sendLogByUuid(record, taskUuid)
+      const result = await client.sendLog(record)
 
       if (result === 'success' || (typeof result === 'object' && 'uuid' in result)) {
-        console.log('===============================================')
+        console.log('')
         console.log('✅ Log sent to Hive successfully')
         console.log(`   Profile: ${profile.name}`)
         console.log(`   Host: ${profile.url}`)
@@ -102,13 +93,17 @@ const boundaries = {
 
         return { success: true, taskUuid }
       } else {
+        console.log('')
         console.error('❌ Failed to send log to Hive:', profile.url)
+        console.log('===============================================')
         return { success: false }
       }
     } catch (e) {
+      console.log('===============================================')
       console.error('❌ Failed to send log to Hive:', profile.url)
       const error = e as Error
       console.error('Error:', error.message)
+      console.log('===============================================')
       return { success: false }
     }
   }
@@ -129,8 +124,6 @@ export const run = createTask({
     // Load forge configuration
     const forge: ForgeConf = await loadConf({})
     const taskDescriptor = forge.tasks[descriptorName as keyof typeof forge.tasks]
-    const projectName = forge.project.name
-    const projectUuid = forge.project.uuid
     const taskUuid = taskDescriptor?.uuid
 
     if (taskDescriptor === undefined) {
@@ -204,7 +197,7 @@ export const run = createTask({
 
     if (profile) {
       try {
-        const logResult = await sendLogToAPI(profile, projectName, logItem, taskUuid, projectUuid)
+        const logResult = await sendLogToAPI(profile, logItem, taskUuid)
 
         if (logResult.success && !logResult.skipRemoteLog && taskUuid) {
           console.log(`🔗 View execution logs: ${profile.url}/tasks/${taskUuid}?tab=logs`)

package/src/tasks/types.ts

@@ -22,6 +22,7 @@ export interface ForgeConf {
   project: {
     name: string
     uuid?: string
+    description?: string
   }
   paths: {
     logs: string
@@ -34,6 +35,9 @@ export interface ForgeConf {
   infra: Infra
   tasks: Record<string, TaskDescriptor>
   runners: Record<string, RunnerDescriptor>
+  build?: {
+    externalPackages?: string[]
+  }
 }
 
 export interface TaskName {