@cloudnux/cli 0.1.0

package/package.json

@@ -0,0 +1,58 @@
+{
+	"name": "@cloudnux/cli",
+	"version": "0.1.0",
+	"license": "MIT",
+	"bin": {
+		"epf": "dist/cli.js"
+	},
+	"type": "module",
+	"engines": {
+		"node": ">=22"
+	},
+	"scripts": {
+		"develop": "tsup --watch && chmod +x dist/cli.js",
+		"build": "tsup && chmod +x dist/cli.js",
+		"link": "yarn link"
+	},
+	"files": [
+		".deploy",
+		"dist",
+		"pakage.json",
+		"README.md"
+	],
+	"dependencies": {
+		"@inkjs/ui": "^2.0.0",
+		"@types/findup-sync": "^4.0.5",
+		"ejs": "^3.1.10",
+		"fast-glob": "^3.3.2",
+		"fastify": "^5.2.1",
+		"fastify-raw-body": "^5.0.0",
+		"findup-sync": "^5.0.0",
+		"immer": "^10.1.1",
+		"ink": "^4.1.0",
+		"ink-spinner": "^5.0.0",
+		"interpret": "^3.1.1",
+		"jsonwebtoken": "^9.0.2",
+		"meow": "^11.0.0",
+		"pino-pretty": "^13.0.0",
+		"react": "^18.2.0",
+		"rechoir": "^0.8.0",
+		"tsup": "^8.3.5",
+		"zustand": "^5.0.2"
+	},
+	"devDependencies": {
+		"@types/ejs": "^3.1.5",
+		"@types/findup-sync": "^4.0.5",
+		"@types/jsonwebtoken": "^9.0.7",
+		"@types/react": "^18.0.32",
+		"@types/rechoir": "^0.6.4",
+		"chalk": "^5.2.0",
+		"ink-testing-library": "^4.0.0",
+		"react-devtools-core": "^6.0.1",
+		"typescript": "^5.0.3"
+	},
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	}
+}

package/readme.md

@@ -0,0 +1,137 @@
+# EntryPoint Framework CLI
+
+A task-based CLI framework for managing cloud function deployments and local development.
+
+## Configuration
+
+Create an 
+
+`epf.config.js` or `.epfrc.js` in your project root:
+
+```typescript
+export default {
+  // Path to modules containing entrypoint.json files
+  modulesPath: './packages/modules/**/entrypoint.json',
+  
+  // Cloud provider: 'aws', 'azure', or 'gcp'
+  cloudProvider: 'aws',
+  
+  // Build output directory
+  workingDir: './.epf',
+  
+  // Environment configurations
+  environments: {
+    develop: {
+      // Development environment tasks
+      tasks: [],
+      // Optional watch task for development
+      watch: {
+        title: "Dev Server",
+        action: async () => {
+          // Development server logic
+        }
+      }
+    },
+    prod: {
+      // Production deployment tasks 
+      tasks: []
+    }
+  }
+}
+```
+
+## Task System
+
+Tasks are the core building blocks of EPF workflows. Each task has:
+
+```typescript
+{
+  // Task display name or function returning name
+  title: string | ((params) => string),
+  
+  // Optional skip condition
+  skip?: (params) => boolean,
+  
+  // Main task action
+  action: (params, executeSubTasks?) => Promise<any>,
+  
+  // Optional subtasks
+  children?: Task[]
+}
+```
+
+## CLI Usage
+
+```bash
+# Run with environment
+epf <environment>
+
+# Specify config file
+epf <environment> --config=./custom-config.js
+```
+
+## Environments
+
+Each environment (
+
+develop
+
+, 
+
+prod
+
+, etc) can define:
+
+- 
+
+tasks
+
+: Array of tasks to execute
+- 
+
+watch
+
+: Optional development server task
+- Custom environment parameters
+
+## Development Mode
+
+The 
+
+watch
+
+ task enables development mode with:
+
+- Real-time logs
+- Local development server
+- Hot reload capability
+- Process runs until terminated
+
+## Task Parameters
+
+Tasks receive parameters including:
+
+```typescript
+{
+  modulesPath: string,    // Path to modules
+  cloudProvider: string,  // Selected cloud provider
+  workingDir: string,    // Build output directory
+  environment: string,   // Current environment name
+  // ...environment specific params
+}
+```
+
+## Project Structure
+
+```
+.
+├── epf.config.js           # CLI configuration
+├── packages/
+│   └── modules/           # Function modules
+│       └── */
+│           └── entrypoint.json  # Module definition
+└── .epf/                  # Build artifacts
+    └── <environment>/     # Environment builds
+```
+
+This CLI provides a structured way to manage cloud function development and deployment workflows across different environments and cloud providers.