@rafter-security/cli 0.5.1 → 0.5.3

package/dist/utils/skill-manager.js

@@ -151,17 +151,17 @@ export class SkillManager {
         }
     }
     /**
-     * Install Rafter Security skill to OpenClaw
+     * Install Rafter Security skill to OpenClaw (verbose result)
      */
-    async installRafterSkill(force = false) {
-        if (!this.isOpenClawInstalled()) {
-            return false;
-        }
+    async installRafterSkillVerbose(force = false) {
         const skillPath = this.getRafterSkillPath();
         const sourcePath = this.getRafterSkillSourcePath();
+        if (!this.isOpenClawInstalled()) {
+            return { ok: false, sourcePath, destPath: skillPath, error: `OpenClaw skills directory not found: ${this.getOpenClawSkillsDir()}` };
+        }
         // Check if already installed and not forcing
         if (!force && this.isRafterSkillInstalled()) {
-            return true;
+            return { ok: true, sourcePath, destPath: skillPath };
         }
         try {
             // Ensure skills directory exists
@@ -169,6 +169,10 @@ export class SkillManager {
             if (!fs.existsSync(skillsDir)) {
                 fs.mkdirSync(skillsDir, { recursive: true });
             }
+            // Verify source exists
+            if (!fs.existsSync(sourcePath)) {
+                return { ok: false, sourcePath, destPath: skillPath, error: `Source skill file not found: ${sourcePath}` };
+            }
             // Copy skill file
             const sourceContent = fs.readFileSync(sourcePath, "utf-8");
             fs.writeFileSync(skillPath, sourceContent, "utf-8");
@@ -180,12 +184,21 @@ export class SkillManager {
             }
             // Migrate old skill-auditor if present
             await this.migrateOldSkill();
-            return true;
+            return { ok: true, sourcePath, destPath: skillPath };
         }
         catch (e) {
-            console.error(`Failed to install Rafter Security skill: ${e}`);
-            return false;
+            return { ok: false, sourcePath, destPath: skillPath, error: String(e) };
+        }
+    }
+    /**
+     * Install Rafter Security skill to OpenClaw
+     */
+    async installRafterSkill(force = false) {
+        const result = await this.installRafterSkillVerbose(force);
+        if (!result.ok && result.error) {
+            console.error(`Failed to install Rafter Security skill: ${result.error}`);
         }
+        return result.ok;
     }
     /**
      * Backup current skill before updating

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rafter-security/cli",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "type": "module",
   "bin": {
     "rafter": "./dist/index.js"

package/resources/rafter-security-skill.md

@@ -46,6 +46,13 @@ rafter agent scan <path>
 - Private keys (RSA, SSH, etc.)
 - 21+ secret patterns
 
+**Exit codes:**
+- `0` — clean, no secrets
+- `1` — secrets found
+- `2` — runtime error (path not found, not a git repo)
+
+**JSON output** (`--json`): Array of `{file, matches[]}` objects. Each match contains `pattern` (name, severity, description), `line`, `column`, and `redacted` value. Raw secrets are never included.
+
 ---
 
 ### /rafter-bash