feat: implement workflow list/view/run

README.md

@@ -182,6 +182,21 @@ fgj release delete v1.2.3
 ### Forgejo Actions
 
 ```bash
+# List workflows
+fgj actions workflow list
+
+# View a workflow
+fgj actions workflow view ci.yml
+
+# Run a workflow (trigger workflow_dispatch)
+fgj actions workflow run deploy.yml
+
+# Run a workflow with inputs
+fgj actions workflow run deploy.yml -f environment=production -f version=1.2.3
+
+# Run a workflow on a specific branch
+fgj actions workflow run deploy.yml -r feature-branch
+
 # List workflow runs
 fgj actions run list
 
@@ -324,6 +339,45 @@ fgj/
 
 Contributions are welcome! Please feel free to submit a Pull Request.
 
+## Missing Features / Roadmap
+
+`fgj` aims to be a drop-in replacement for `gh` when working with Forgejo instances. While we've implemented the core features, some `gh` commands are not yet available:
+
+### Forgejo Actions / Workflows
+
+**Implemented:**
+- ✅ `workflow list` - List all workflows
+- ✅ `workflow view` - View workflow details and latest run
+- ✅ `workflow run` - Trigger workflow_dispatch with inputs and ref support
+- ✅ `run list` - List workflow runs
+- ✅ `run view` - View run details, jobs, and logs
+- ✅ `secret list/create/delete` - Manage repository secrets
+- ✅ `variable list/get/create/update/delete` - Manage repository variables
+
+**Not Yet Implemented:**
+- ❌ `workflow enable/disable` - Enable or disable workflows
+- ❌ `run watch` - Follow a workflow run in real-time
+- ❌ `run rerun` - Rerun entire run, failed jobs, or specific jobs
+- ❌ `run cancel` - Cancel a running workflow
+- ❌ `run delete` - Delete a workflow run
+- ❌ `run download` - Download workflow run artifacts
+- ❌ Organization-level secrets and variables
+
+### Other GitHub CLI Features
+
+Some other `gh` features that could be added in the future:
+- ❌ `gh gist` - Gist management (if Forgejo adds gist support)
+- ❌ `gh project` - Project board management
+- ❌ `gh label` - Label management
+- ❌ `gh milestone` - Milestone management
+- ❌ `gh ssh-key` - SSH key management
+- ❌ `gh gpg-key` - GPG key management
+- ❌ `gh org` - Organization management
+- ❌ `gh codespace` - Codespace management (N/A for Forgejo)
+- ❌ `gh extension` - Extension management
+
+We welcome contributions to implement any of these features! Please check the issues or create a new one to discuss implementation before starting work.
+
 ## License
 
 MIT License