@powerformer/refly-cli 0.1.4 → 0.1.6

package/skill/references/api-errors.md

@@ -1,120 +0,0 @@
-# API Errors Reference
-
-All CLI errors use stable error codes for reliable error handling.
-
-## Error Response Format
-
-```json
-{
-  "ok": false,
-  "type": "error",
-  "version": "1.0",
-  "error": {
-    "code": "ERROR_CODE",
-    "message": "Human-readable description",
-    "details": { },
-    "hint": "Suggested action"
-  }
-}
-```
-
-## Error Codes
-
-### Authentication Errors
-
-| Code | Description | Hint |
-|------|-------------|------|
-| AUTH_REQUIRED | Not authenticated or token expired | Run `refly login` |
-| AUTH_INVALID | Invalid credentials | Check API key |
-| AUTH_EXPIRED | Token has expired | Run `refly login` |
-
-### CLI Errors
-
-| Code | Description | Hint |
-|------|-------------|------|
-| CLI_NOT_FOUND | CLI not installed or not in PATH | Run `npm i -g @refly/cli` |
-| CONFIG_ERROR | Configuration file corrupted | Run `refly init` |
-| VERSION_MISMATCH | CLI version incompatible with API | Run `npm update -g @refly/cli` |
-
-### Builder Errors
-
-| Code | Description | Hint |
-|------|-------------|------|
-| BUILDER_NOT_STARTED | No active builder session | Run `refly builder start` |
-| BUILDER_ALREADY_STARTED | Builder session already exists | Run `refly builder abort` first |
-| VALIDATION_REQUIRED | Must validate before commit | Run `refly builder validate` |
-| VALIDATION_ERROR | DAG validation failed | See error details |
-| DUPLICATE_NODE_ID | Node ID already exists | Use unique node ID |
-| NODE_NOT_FOUND | Referenced node does not exist | Check node ID |
-| CYCLE_DETECTED | Circular dependency in DAG | Remove cycle |
-| INVALID_STATE | Invalid state transition | Check `refly builder status` |
-
-### Workflow Errors
-
-| Code | Description | Hint |
-|------|-------------|------|
-| WORKFLOW_NOT_FOUND | Workflow does not exist | Check workflow ID |
-| WORKFLOW_EXISTS | Workflow name already taken | Use different name |
-| RUN_NOT_FOUND | Workflow run does not exist | Check run ID |
-| RUN_FAILED | Workflow execution failed | Check run details |
-| RUN_ABORTED | Workflow was aborted | - |
-
-### Node Errors
-
-| Code | Description | Hint |
-|------|-------------|------|
-| INVALID_NODE_TYPE | Unknown node type | Run `refly node types` |
-| INVALID_NODE_INPUT | Node input validation failed | Check input schema |
-| NODE_EXECUTION_ERROR | Node execution failed | See error details |
-
-### Network Errors
-
-| Code | Description | Hint |
-|------|-------------|------|
-| NETWORK_ERROR | Cannot connect to API | Check internet connection |
-| TIMEOUT | Request timed out | Retry later |
-| API_ERROR | API returned error | See error message |
-
-### General Errors
-
-| Code | Description | Hint |
-|------|-------------|------|
-| NOT_FOUND | Resource not found | Verify resource ID |
-| CONFLICT | Resource conflict | Refresh and retry |
-| PERMISSION_DENIED | Insufficient permissions | Check access rights |
-| INVALID_INPUT | Invalid input data | Check input format |
-| INTERNAL_ERROR | Unexpected error | Report issue |
-
-## Handling Errors
-
-### In Claude Code
-
-When `ok=false`:
-1. Do NOT proceed with the operation
-2. Show the user the `error.message`
-3. Suggest the action in `error.hint`
-4. If `error.details` exists, include relevant information
-
-### Example Error Handling
-
-```bash
-# Check status before operations
-result=$(refly status)
-if [ "$(echo $result | jq -r '.ok')" = "false" ]; then
-  code=$(echo $result | jq -r '.error.code')
-  hint=$(echo $result | jq -r '.error.hint')
-  echo "Error: $code. Try: $hint"
-  exit 1
-fi
-```
-
-## Exit Codes
-
-| Exit Code | Meaning |
-|-----------|---------|
-| 0 | Success |
-| 1 | General error |
-| 2 | Authentication error |
-| 3 | Validation error |
-| 4 | Network error |
-| 5 | Not found |

package/skill/references/node-types.md

@@ -1,91 +0,0 @@
-# Node Types Reference
-
-This document describes the available node types for Refly workflows.
-
-## Fetching Node Types
-
-Use the CLI to get the current list of supported node types:
-
-```bash
-refly node types
-```
-
-Response:
-```json
-{
-  "ok": true,
-  "type": "node.types",
-  "version": "1.0",
-  "payload": {
-    "types": [
-      {
-        "name": "document.parse",
-        "description": "Parse document content",
-        "inputSchema": { ... },
-        "outputSchema": { ... }
-      }
-    ]
-  }
-}
-```
-
-## Node Type Cache
-
-- Location: `~/.refly/cache/node-types.json`
-- TTL: 24 hours
-- Force refresh: `refly node types --refresh`
-
-## Common Node Categories
-
-### Document Processing
-- `document.parse` - Parse various document formats
-- `document.export` - Export to different formats
-- `document.split` - Split document into chunks
-
-### LLM Operations
-- `llm.summarize` - Summarize text content
-- `llm.translate` - Translate content
-- `llm.generate` - Generate content from prompt
-- `llm.chat` - Interactive chat completion
-
-### Data Operations
-- `data.input` - Accept external input
-- `data.output` - Produce workflow output
-- `data.merge` - Merge multiple inputs
-- `data.filter` - Filter data by criteria
-- `data.transform` - Transform data structure
-
-### Control Flow
-- `control.condition` - Conditional branching
-- `control.loop` - Iterate over items
-- `control.parallel` - Parallel execution
-
-## Testing Nodes
-
-Run a single node for debugging:
-
-```bash
-refly node run --type "llm.summarize" --input '{"text": "Long text here..."}'
-```
-
-Response:
-```json
-{
-  "ok": true,
-  "type": "node.run",
-  "version": "1.0",
-  "payload": {
-    "result": { ... },
-    "metrics": {
-      "durationMs": 1234,
-      "tokensUsed": 500
-    }
-  }
-}
-```
-
-## Notes
-
-- Node types depend on your Refly backend configuration
-- Some nodes may require specific permissions
-- Input/output schemas are validated at runtime

package/skill/references/workflow-schema.md

@@ -1,95 +0,0 @@
-# Workflow Schema Reference
-
-This document defines the canonical workflow spec used by `refly workflow create --spec`.
-
-## Spec Shape (v1)
-
-```json
-{
-  "version": 1,
-  "name": "string (required)",
-  "description": "string (optional)",
-  "nodes": [
-    {
-      "id": "string (required, unique)",
-      "type": "string (required, must be valid node type)",
-      "input": "object (required, node-specific configuration)",
-      "dependsOn": "string[] (optional, list of node IDs)"
-    }
-  ],
-  "metadata": {
-    "tags": "string[] (optional)",
-    "owner": "string (optional)"
-  }
-}
-```
-
-## Field Descriptions
-
-### Top-level Fields
-
-| Field | Type | Required | Description |
-|-------|------|----------|-------------|
-| version | number | Yes | Schema version, currently `1` |
-| name | string | Yes | Workflow name, must be unique per user |
-| description | string | No | Human-readable description |
-| nodes | array | Yes | List of workflow nodes |
-| metadata | object | No | Additional metadata |
-
-### Node Fields
-
-| Field | Type | Required | Description |
-|-------|------|----------|-------------|
-| id | string | Yes | Unique identifier within workflow |
-| type | string | Yes | Node type from `refly node types` |
-| input | object | Yes | Node-specific input configuration |
-| dependsOn | string[] | No | IDs of nodes that must complete first |
-
-## DAG Rules
-
-1. **Unique IDs**: Each node `id` must be unique within the workflow
-2. **No Cycles**: The dependency graph must be acyclic
-3. **Valid References**: All `dependsOn` entries must reference existing node IDs
-4. **No Self-Reference**: A node cannot depend on itself
-5. **Valid Types**: All `type` values must be in the allowed node types list
-
-## Examples
-
-### Simple Sequential Workflow
-
-```json
-{
-  "version": 1,
-  "name": "document-processor",
-  "nodes": [
-    { "id": "parse", "type": "document.parse", "input": { "format": "pdf" } },
-    { "id": "summarize", "type": "llm.summarize", "input": {}, "dependsOn": ["parse"] },
-    { "id": "export", "type": "document.export", "input": { "format": "md" }, "dependsOn": ["summarize"] }
-  ]
-}
-```
-
-### Parallel Processing
-
-```json
-{
-  "version": 1,
-  "name": "parallel-analysis",
-  "nodes": [
-    { "id": "input", "type": "data.input", "input": {} },
-    { "id": "analyze-a", "type": "analyze.sentiment", "input": {}, "dependsOn": ["input"] },
-    { "id": "analyze-b", "type": "analyze.keywords", "input": {}, "dependsOn": ["input"] },
-    { "id": "merge", "type": "data.merge", "input": {}, "dependsOn": ["analyze-a", "analyze-b"] }
-  ]
-}
-```
-
-## Validation Errors
-
-| Error | Description |
-|-------|-------------|
-| DUPLICATE_NODE_ID | Two nodes have the same ID |
-| INVALID_NODE_TYPE | Node type not in allowed list |
-| MISSING_DEPENDENCY | dependsOn references non-existent node |
-| CYCLE_DETECTED | Circular dependency found |
-| MISSING_REQUIRED_FIELD | Required field is missing |