@forgehive/forge-cli 0.3.9 → 0.3.11

package/dist/test/tasks/create.test.js

@@ -35,11 +35,10 @@ export const newTask = createTask({
   boundaries,
   fn: async function (argv, boundaries) {
     console.log('input:', argv)
-    console.log('boundaries:', boundaries)
+    console.log('boundaries:', Object.keys(boundaries))
     // Your task implementation goes here
-    const status = { status: 'Ok' }
 
-    return status
+    return {}
   }
 })
 
@@ -94,5 +93,7 @@ describe('Create task', () => {
         const forgeContent = await fs.promises.readFile(path_1.default.join(rootDir, 'forge.json'), 'utf-8');
         const forgeConf = JSON.parse(forgeContent);
         expect(forgeConf.tasks['sample:newTask']).toBeDefined();
+        expect(forgeConf.tasks['sample:newTask'].uuid).toBeDefined();
+        expect(typeof forgeConf.tasks['sample:newTask'].uuid).toBe('string');
     });
 });

package/forge.json

@@ -118,6 +118,20 @@
     "docs:download": {
       "path": "src/tasks/docs/download.ts",
       "handler": "download"
+    },
+    "project:create": {
+      "path": "src/tasks/project/create.ts",
+      "handler": "create"
+    },
+    "project:link": {
+      "path": "src/tasks/project/link.ts",
+      "handler": "link",
+      "uuid": "cb9f82e1-d397-46d9-9f0d-2b0e3becbfa1"
+    },
+    "project:unlink": {
+      "path": "src/tasks/project/unlink.ts",
+      "handler": "unlink",
+      "uuid": "414d37de-793c-4d01-899d-69515f5e0948"
     }
   },
   "runners": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgehive/forge-cli",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "description": "TypeScript CLI application",
   "license": "MIT",
   "main": "dist/index.js",
@@ -17,7 +17,8 @@
       "@forgehive/task": "^0.2.5",
       "esbuild": "^0.25.0",
       "handlebars": "^4.7.8",
-      "minimist": "^1.2.8"
+      "minimist": "^1.2.8",
+      "typescript": "^5.3.3"
     }
   },
   "dependencies": {
@@ -27,11 +28,13 @@
     "esbuild": "^0.25.0",
     "handlebars": "^4.7.8",
     "minimist": "^1.2.8",
+    "typescript": "^5.3.3",
+    "uuid": "^11.1.0",
     "@forgehive/hive-sdk": "0.1.2",
     "@forgehive/record-tape": "0.2.5",
-    "@forgehive/task": "0.2.5",
     "@forgehive/runner": "0.2.5",
-    "@forgehive/schema": "0.1.4"
+    "@forgehive/schema": "0.1.4",
+    "@forgehive/task": "0.2.5"
   },
   "devDependencies": {
     "@types/archiver": "^6.0.3",

package/src/runner.ts

@@ -20,7 +20,6 @@ import { describe as describeTask } from './tasks/task/describe'
 import { fingerprint as fingerprintTask } from './tasks/task/fingerprint'
 import { invoke as invokeTask } from './tasks/task/invoke'
 
-
 import { create as createRunner } from './tasks/runner/create'
 import { remove as removeRunner } from './tasks/runner/remove'
 import { bundle as bundleRunner } from './tasks/runner/bundle'
@@ -34,6 +33,10 @@ import { switchProfile } from './tasks/auth/switch'
 import { list as listProfiles } from './tasks/auth/list'
 import { remove as removeProfile } from './tasks/auth/remove'
 
+import { create as createProject } from './tasks/project/create'
+import { link as linkProject } from './tasks/project/link'
+import { unlink as unlinkProject } from './tasks/project/unlink'
+
 interface CliParsedArguments extends RunnerParsedArguments {
   action: string;
 }
@@ -81,6 +84,11 @@ runner.load('auth:switch', switchProfile)
 runner.load('auth:list', listProfiles)
 runner.load('auth:remove', removeProfile)
 
+// Project commands
+runner.load('project:create', createProject)
+runner.load('project:link', linkProject)
+runner.load('project:unlink', unlinkProject)
+
 // Set handler
 runner.setHandler(async (data: ParsedArgs): Promise<unknown> => {
   const parsedArgs = runner.parseArguments(data)
@@ -167,7 +175,7 @@ runner.setHandler(async (data: ParsedArgs): Promise<unknown> => {
       })
     } else if (taskName === 'auth:switch' || taskName === 'auth:remove') {
       result = await task.run({
-        profileName: action
+        profileName: String(action)
       })
     } else if (taskName === 'docs:download') {
       const { path } = args as { path?: string }
@@ -175,6 +183,20 @@ runner.setHandler(async (data: ParsedArgs): Promise<unknown> => {
       result = await task.run({
         path
       })
+    } else if (taskName === 'project:create') {
+      const { projectName, description } = args as { projectName?: string, description?: string }
+
+      result = await task.run({
+        projectName,
+        description
+      })
+    } else if (taskName === 'project:link') {
+      const { uuid } = args as { uuid: string }
+      result = await task.run({
+        uuid
+      })
+    } else if (taskName === 'project:unlink') {
+      result = await task.run({})
     } else {
       result = await task.run(args)
 
@@ -183,7 +205,7 @@ runner.setHandler(async (data: ParsedArgs): Promise<unknown> => {
       }
     }
 
-    if (taskName === 'task:describe' || taskName === 'task:list') {
+    if (taskName === 'task:describe' || taskName === 'task:list' || taskName === 'auth:list') {
       silent = true
     }
 

package/src/tasks/auth/list.ts

@@ -25,19 +25,33 @@ export const list = createTask({
       return { status: 'Ok', profiles: [] }
     }
 
-    console.log('Available profiles:')
+    // Show current profile
+    const currentProfile = profiles.profiles.find(profile => profile.name === profiles.default)
+    if (currentProfile) {
+      console.log('Current Profile:')
+      console.log(`  Name: ${currentProfile.name}`)
+      console.log(`  API Key: ${currentProfile.apiKey}`)
+      console.log(`  URL: ${currentProfile.url}`)
+      console.log('')
+    }
+
+    console.log('Available profiles:\n')
+
+    const tableData = profiles.profiles.map(profile => ({
+      Name: profile.name,
+      'API Key': profile.apiKey,
+      URL: profile.url
+    }))
 
-    profiles.profiles.forEach(profile => {
-      const isDefault = profile.name === profiles.default
-      const prefix = isDefault ? '* ' : '  '
-      console.log(`${prefix}${profile.name} - API Key: ${profile.apiKey}`)
-    })
+    console.table(tableData, ['Name', 'API Key', 'URL'])
 
     console.log('\nUse auth:add to create or update a profile')
-    console.log('\nUse auth:switch to switch to a profile')
+    console.log('Use auth:switch [name] or auth:switch [index] to switch profiles')
+    console.log('========================================')
 
     return {
-      default: profiles.default
+      default: profiles.default,
+      profiles: tableData
     }
   }
 })

package/src/tasks/auth/load.ts

@@ -43,6 +43,7 @@ export const load = createTask({
       profiles = JSON.parse(content) as Profiles
     } catch (_error) {
       console.log('Creating profiles.json')
+      console.log('===============================================')
       await fs.writeFile(profilesPath, '{"profiles": [], "default": ""}')
     }
 

package/src/tasks/auth/switch.ts

@@ -1,6 +1,6 @@
 // TASK: switch
 // Run this task with:
-// forge task:run auth:switch --profileName [name]
+// forge auth:switch [name] or forge auth:switch [index]
 
 import { createTask } from '@forgehive/task'
 import { Schema } from '@forgehive/schema'
@@ -31,23 +31,39 @@ export const switchProfile = createTask({
     // Load profiles
     const profiles = await loadProfiles({})
 
-    // Check if profile exists
-    const profileExists = profiles.profiles.some(profile => profile.name === profileName)
+    if (profiles.profiles.length === 0) {
+      throw new Error('No profiles found. Use auth:add to create one.')
+    }
+
+    let targetProfile: string
 
-    if (!profileExists) {
-      throw new Error(`Profile "${profileName}" not found. Use auth:list to see available profiles.`)
+    // Check if profileName is a number (index)
+    const indexInput = parseInt(profileName, 10)
+    if (!isNaN(indexInput)) {
+      // Using index
+      if (indexInput < 0 || indexInput >= profiles.profiles.length) {
+        throw new Error(`Profile index ${indexInput} is out of range. Use auth:list to see available profiles (0-${profiles.profiles.length - 1}).`)
+      }
+      targetProfile = profiles.profiles[indexInput].name
+    } else {
+      // Using profile name
+      const profileExists = profiles.profiles.some(profile => profile.name === profileName)
+      if (!profileExists) {
+        throw new Error(`Profile "${profileName}" not found. Use auth:list to see available profiles.`)
+      }
+      targetProfile = profileName
     }
 
     // Update default profile
-    profiles.default = profileName
+    profiles.default = targetProfile
 
     // Save updated profiles
     await persistProfiles(profiles)
 
-    console.log(`Switched to profile: ${profileName}`)
+    console.log(`Switched to profile: ${targetProfile}`)
 
     return {
-      default: profileName
+      default: targetProfile
     }
   }
 })

package/src/tasks/conf/info.ts

@@ -27,7 +27,29 @@ export const info = createTask({
     const packageJsonContent = await readFile(packageJsonPath)
     const packageJson = JSON.parse(packageJsonContent)
 
-    const config = await loadConfig({})
+    let config
+    try {
+      config = await loadConfig({})
+    } catch (error: unknown) {
+      if (error instanceof Error && error.message.includes('ENOENT')) {
+        console.log('============ Forge CLI Information ============')
+        console.log('===============================================')
+        console.log()
+        console.log(`Version: ${packageJson.version}`)
+        console.log()
+        console.log('❌ No forge.json file found in current directory.')
+        console.log('   Run "forge init" to create a new Forge project.')
+        console.log()
+        console.log('===============================================')
+        return {
+          version: packageJson.version,
+          profile: null,
+          paths: null,
+          error: 'No forge.json found'
+        }
+      }
+      throw error
+    }
 
     // Display human-friendly information
     console.log('===============================================')

package/src/tasks/project/README.md

@@ -0,0 +1,268 @@
+# Project Commands
+
+This directory contains ForgeHive CLI commands for project management operations.
+
+## Commands
+
+### `project:create`
+
+Creates a new project in ForgeHive with automatic UUID generation and API integration.
+
+#### Usage
+
+```bash
+forge project:create [--projectName="My Project"] [--description="Project description"]
+```
+
+#### Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `projectName` | string | No | Name of the project to create. If not provided, uses the project name from `forge.json` |
+| `description` | string | No | Optional description for the project |
+
+#### Behavior
+
+1. **UUID Management**: Checks if the local `forge.json` has a project UUID
+   - If no UUID exists, generates a new UUID v4 and saves it to `forge.json`
+   - If UUID already exists, uses the existing one
+
+2. **Authentication**: Uses the current profile from `auth:list` for API authentication
+   - Requires a valid profile set via `auth:add` and `auth:switch`
+   - Uses profile's `apiKey`, `apiSecret`, and `url` for the request
+
+3. **API Request**: Makes a POST request to `/api/projects` with:
+   - `projectName`: The provided project name
+   - `description`: The provided description (or empty string if not provided)
+   - `uuid`: The project UUID (generated or existing)
+
+4. **Response**: Returns the created project details including:
+   - Project UUID
+   - Project name
+   - Team information
+   - Creation timestamps
+
+#### Examples
+
+```bash
+# Create a project using the name from forge.json
+forge project:create
+
+# Create a project with custom name
+forge project:create --projectName="My New Project"
+
+# Create a project with custom name and description
+forge project:create --projectName="Analytics Dashboard" --description="Customer analytics and reporting platform"
+
+# Create a project using forge.json name but with description
+forge project:create --description="Using the default project name from configuration"
+```
+
+#### Success Output
+
+```
+Generated and saved project UUID: 550e8400-e29b-41d4-a716-446655440000
+Project created successfully!
+Project UUID: 550e8400-e29b-41d4-a716-446655440000
+Project Name: My New Project
+
+🌐 View your project on the dashboard: https://api.forgehive.com/dashboard/projects/550e8400-e29b-41d4-a716-446655440000
+```
+
+#### Error Cases
+
+- **No Project Name**: If no `--projectName` is provided and `forge.json` doesn't contain a project name
+- **No Profile**: If no authentication profile is configured
+- **Invalid Profile**: If the current profile is invalid or expired
+- **API Errors**: Network issues, server errors, or validation failures
+- **Duplicate Names**: If a project with the same name already exists in the team
+
+#### File Changes
+
+When run, this command may modify:
+- `forge.json`: Adds or updates the project UUID if one doesn't exist
+
+#### Dependencies
+
+- Requires `@forgehive/task` framework
+- Requires `@forgehive/schema` for validation
+- Uses `uuid` package for UUID generation
+- Integrates with `auth:loadCurrent` for profile management
+- Integrates with `conf:load` for configuration management
+
+#### API Integration
+
+This command integrates with the ForgeHive Projects API. See the [Projects API Documentation](../../../../../../../hive/docs/projects-api.md) for detailed API specifications.
+
+---
+
+## Project Configuration
+
+Projects are configured via the `forge.json` file in your project root:
+
+```json
+{
+  "project": {
+    "name": "My Project",
+    "uuid": "550e8400-e29b-41d4-a716-446655440000"
+  }
+}
+```
+
+The UUID is automatically generated and managed by the CLI commands.
+
+---
+
+### `project:link`
+
+Links an existing remote project to the local project by validating the UUID and updating forge.json.
+
+#### Usage
+
+```bash
+forge project:link [uuid]
+```
+
+#### Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `uuid` | string (UUID) | Yes | UUID of the existing remote project to link |
+
+#### Behavior
+
+1. **UUID Validation**: Validates the provided UUID format using regex
+2. **Remote Verification**: Makes a GET request to `/api/projects/{uuid}` to verify the project exists
+3. **Authentication**: Uses the current profile for API authentication
+4. **Project Details**: Displays project information (name, description, task count) if found
+5. **Local Update**: Updates the local `forge.json` with the verified UUID
+
+#### Examples
+
+```bash
+# Link to an existing remote project
+forge project:link 550e8400-e29b-41d4-a716-446655440000
+```
+
+#### Success Output
+
+```
+Checking if project 550e8400-e29b-41d4-a716-446655440000 exists on https://api.forgehive.com...
+✓ Found project: Customer Analytics
+  Description: Analytics platform for customer behavior analysis
+  Tasks: 3 task(s)
+
+✓ Successfully linked project 550e8400-e29b-41d4-a716-446655440000 to local forge.json
+  Local project name: My Local Project
+  Remote project name: Customer Analytics
+
+🌐 View your project on the dashboard: https://api.forgehive.com/dashboard/projects/550e8400-e29b-41d4-a716-446655440000
+```
+
+#### Error Cases
+
+- **Invalid UUID Format**: If the provided UUID doesn't match the expected format
+- **Project Already Linked**: If the local project already has a UUID in forge.json
+- **Project Not Found**: If the UUID doesn't exist on the remote server (404)
+- **Authentication Failed**: If the current profile credentials are invalid (401)
+- **No Profile**: If no authentication profile is configured
+- **Network Issues**: Connection problems or server errors
+
+#### Error Examples
+
+```bash
+# Invalid UUID format
+forge project:link invalid-uuid
+# Error: Invalid UUID format: invalid-uuid. Please provide a valid UUID.
+
+# Project already linked
+forge project:link 550e8400-e29b-41d4-a716-446655440000
+# Error: Project is already linked to UUID: 123e4567-e89b-12d3-a456-426614174000. Use a different project or remove the existing UUID from forge.json first.
+
+# Project not found
+forge project:link 00000000-0000-0000-0000-000000000000
+# Error: Project with UUID 00000000-0000-0000-0000-000000000000 not found on https://api.forgehive.com. Please verify the UUID is correct.
+
+# Authentication failed
+forge project:link 550e8400-e29b-41d4-a716-446655440000
+# Error: Authentication failed. Please check your profile credentials with 'forge auth:list'.
+```
+
+#### File Changes
+
+When run successfully, this command modifies:
+- `forge.json`: Updates the `project.uuid` field with the verified remote project UUID
+
+#### Dependencies
+
+- Requires `@forgehive/task` framework
+- Requires `@forgehive/schema` for validation
+- Integrates with `auth:loadCurrent` for profile management
+- Integrates with `conf:load` for configuration management
+- Uses the ForgeHive Projects API `/api/projects/{uuid}` endpoint
+
+---
+
+### `project:unlink`
+
+Removes the project UUID link from the local forge.json, allowing the project to be linked to a different remote project.
+
+#### Usage
+
+```bash
+forge project:unlink
+```
+
+#### Parameters
+
+This command takes no parameters.
+
+#### Behavior
+
+1. **UUID Check**: Verifies that a project UUID exists in forge.json
+2. **Local Update**: Removes the UUID field from the project configuration
+3. **Confirmation**: Shows the UUID that was removed and next steps
+
+#### Examples
+
+```bash
+# Unlink the current project
+forge project:unlink
+```
+
+#### Success Output
+
+```
+✓ Successfully unlinked project from UUID: 550e8400-e29b-41d4-a716-446655440000
+  The project is no longer linked to a remote project.
+  You can now link to a different project using 'forge project:link [uuid]'
+```
+
+#### Error Cases
+
+- **No UUID Found**: If the project is not currently linked (no UUID in forge.json)
+
+#### Error Examples
+
+```bash
+# No project linked
+forge project:unlink
+# Error: No project UUID found in forge.json. The project is not currently linked to a remote project.
+```
+
+#### File Changes
+
+When run successfully, this command modifies:
+- `forge.json`: Removes the `project.uuid` field completely
+
+#### Dependencies
+
+- Requires `@forgehive/task` framework
+- Requires `@forgehive/schema` for validation
+- Integrates with `conf:load` for configuration management
+
+**Note**: This command only affects the local forge.json file. It does not make any API calls or modify anything on the remote server.
+
+---
+
+## Project Configuration

package/src/tasks/project/create.ts

@@ -0,0 +1,111 @@
+// TASK: create
+// Run this task with:
+// forge task:run project:create
+
+import { createTask } from '@forgehive/task'
+import { Schema } from '@forgehive/schema'
+import { v4 as uuidv4 } from 'uuid'
+import fs from 'fs/promises'
+import path from 'path'
+
+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 schema = new Schema({
+  projectName: Schema.string().optional(),
+  description: Schema.string().optional()
+})
+
+const boundaries = {
+  loadConf: loadConf.asBoundary(),
+  loadCurrentProfile: loadCurrentProfile.asBoundary(),
+  writeFile: async (filePath: string, content: string): Promise<void> => {
+    await fs.writeFile(filePath, content, 'utf-8')
+  },
+  createProject: async (profile: Profile, payload: { projectName: string; description: string; uuid: string }): Promise<Response> => {
+    const authToken = `${profile.apiKey}:${profile.apiSecret}`
+    return await fetch(`${profile.url}/api/projects`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${authToken}`
+      },
+      body: JSON.stringify(payload)
+    })
+  }
+}
+
+export const create = createTask({
+  name,
+  description,
+  schema,
+  boundaries,
+  fn: async function (argv, { loadConf, loadCurrentProfile, writeFile, createProject }) {
+    const { projectName: inputProjectName, 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
+        }
+      }
+
+      await writeFile(forgePath, JSON.stringify(updatedConf, null, 2))
+      console.log(`Generated and saved project UUID: ${projectUuid}`)
+    }
+
+    // Load current profile for API authentication
+    const profile = await loadCurrentProfile({})
+
+    // Prepare API request payload
+    const payload = {
+      projectName,
+      description: description || '',
+      uuid: projectUuid
+    }
+
+    // Make API request to create project
+    const response = await createProject(profile, payload)
+
+    if (!response.ok) {
+      const errorText = await response.text()
+      throw new Error(`Failed to create project: ${response.status} ${response.statusText} - ${errorText}`)
+    }
+
+    const result = await response.json()
+
+    console.log('Project created successfully!')
+    console.log(`Project UUID: ${result.project.uuid}`)
+    console.log(`Project Name: ${result.project.projectName}`)
+    console.log(`\n🌐 View your project on the dashboard: ${profile.url}/dashboard/projects/${result.project.uuid}`)
+
+    return {
+      success: true,
+      project: result.project,
+      localUuid: projectUuid
+    }
+  }
+})
+