@powerformer/refly-cli 0.1.15 → 0.1.17

package/dist/index.d.ts

@@ -1,5 +1,11 @@
 import { z } from 'zod';
 
+interface SuggestedFix {
+    field?: string;
+    format?: string;
+    example?: string;
+}
+
 /**
  * Unified output helpers for CLI commands.
  * Supports multiple output formats: json, pretty, compact, plain.
@@ -17,6 +23,13 @@ interface ErrorDetail {
     message: string;
     details?: Record<string, unknown>;
     hint?: string;
+    suggestedFix?: SuggestedFix;
+    /**
+     * Indicates if the error can be fixed by adjusting parameters.
+     * - true: Fix the parameters (see suggestedFix) and retry the SAME command
+     * - false: The approach may not work, consider alternatives
+     */
+    recoverable?: boolean;
 }
 interface ErrorResponse {
     ok: false;
@@ -67,7 +80,8 @@ declare class CLIError extends Error {
     readonly code: ErrorCode;
     readonly details?: Record<string, unknown> | undefined;
     readonly hint?: string | undefined;
-    constructor(code: ErrorCode, message: string, details?: Record<string, unknown> | undefined, hint?: string | undefined);
+    readonly suggestedFix?: SuggestedFix | undefined;
+    constructor(code: ErrorCode, message: string, details?: Record<string, unknown> | undefined, hint?: string | undefined, suggestedFix?: SuggestedFix | undefined);
 }
 declare class AuthError extends CLIError {
     constructor(message: string, hint?: string);
@@ -244,17 +258,31 @@ declare function verifyConnection(): Promise<{
 }>;
 
 /**
- * Skill installer - copies SKILL.md and references to Claude Code directories.
+ * Skill installer - copies SKILL.md and rules to Refly skill directory,
+ * then creates symlink from Claude Code directory.
+ *
+ * Target structure:
+ * ~/.refly/skills/base/
+ * ├── SKILL.md
+ * └── rules/
+ *     ├── workflow.md
+ *     ├── node.md
+ *     ├── file.md
+ *     └── skill.md
+ *
+ * Symlink:
+ * ~/.claude/skills/refly → ~/.refly/skills/base/
  */
 interface InstallResult {
     skillInstalled: boolean;
     skillPath: string | null;
+    symlinkPath: string | null;
     commandsInstalled: boolean;
     commandsPath: string | null;
     version: string;
 }
 /**
- * Install skill files to Claude Code directories
+ * Install skill files to Refly directory and create symlink to Claude Code
  */
 declare function installSkill(): InstallResult;
 /**
@@ -264,6 +292,7 @@ declare function isSkillInstalled(): {
     installed: boolean;
     upToDate: boolean;
     currentVersion?: string;
+    symlinkValid?: boolean;
 };
 
 export { AuthError, CLIError, type CLIResponse, ErrorCodes, type ErrorDetail, type ErrorResponse, type SuccessResponse, ValidationError, apiRequest, getApiEndpoint, installSkill, isAuthenticated, isSkillInstalled, loadConfig, saveConfig, verifyConnection };