@intranefr/superbackend 1.6.7 → 1.7.8

package/autochangelog-cli/src/cli/utils/output.js

@@ -0,0 +1,357 @@
+const chalk = require('chalk');
+
+/**
+ * Output utility for CLI operations
+ * Handles both human-readable and machine-parseable output formats
+ */
+
+class OutputManager {
+  constructor() {
+    this.jsonMode = !process.stdout.isTTY;
+    this.colorEnabled = process.stdout.isTTY;
+  }
+
+  /**
+   * Set JSON output mode
+   * @param {boolean} enabled - Enable or disable JSON mode
+   */
+  setJsonMode(enabled) {
+    this.jsonMode = enabled;
+    if (enabled) {
+      this.colorEnabled = false;
+    }
+  }
+
+  /**
+   * Check if JSON mode is enabled
+   * @returns {boolean} True if JSON mode is enabled
+   */
+  isJsonMode() {
+    return this.jsonMode;
+  }
+
+  /**
+   * Set color enabled/disabled
+   * @param {boolean} enabled - Enable or disable colors
+   */
+  setColorEnabled(enabled) {
+    this.colorEnabled = enabled && process.stdout.isTTY;
+  }
+
+  /**
+   * Output data in appropriate format
+   * @param {Object} data - Data to output
+   * @param {Object} options - Output options
+   */
+  output(data, options = {}) {
+    const { success = true, message, data: payload, error, metadata } = data;
+    
+    if (this.jsonMode) {
+      // JSON output for machines
+      const output = {
+        success,
+        timestamp: new Date().toISOString(),
+        ...message && { message },
+        ...payload && { data: payload },
+        ...error && { error },
+        ...metadata && { metadata },
+      };
+      
+      console.log(JSON.stringify(output, null, 2));
+    } else {
+      // Human-readable output
+      if (success) {
+        if (message) {
+          console.log(chalk.green(`✅ ${message}`));
+        }
+        if (payload) {
+          this.printData(payload);
+        }
+      } else {
+        if (error) {
+          this.printError(error);
+        } else if (message) {
+          console.log(chalk.red(`❌ ${message}`));
+        }
+      }
+      
+      if (metadata && Object.keys(metadata).length > 0) {
+        this.printMetadata(metadata);
+      }
+    }
+  }
+
+  /**
+   * Print structured data in human-readable format
+   * @param {Object|Array} data - Data to print
+   */
+  printData(data) {
+    if (Array.isArray(data)) {
+      if (data.length === 0) {
+        console.log(chalk.gray('No results found'));
+        return;
+      }
+      
+      data.forEach((item, index) => {
+        this.printObject(item, index > 0);
+      });
+    } else if (typeof data === 'object' && data !== null) {
+      this.printObject(data);
+    } else {
+      console.log(data);
+    }
+  }
+
+  /**
+   * Print a single object with formatting
+   * @param {Object} obj - Object to print
+   * @param {boolean} separator - Whether to add separator
+   */
+  printObject(obj, separator = false) {
+    if (separator) {
+      console.log('');
+    }
+    
+    Object.entries(obj).forEach(([key, value]) => {
+      const formattedKey = this.formatKey(key);
+      const formattedValue = this.formatValue(value);
+      console.log(`${chalk.cyan(formattedKey)}: ${formattedValue}`);
+    });
+  }
+
+  /**
+   * Print error information
+   * @param {Object} error - Error object
+   */
+  printError(error) {
+    const { code, type, message, details, suggestions } = error;
+    
+    console.log(chalk.red(`❌ ${message}`));
+    
+    if (code) {
+      console.log(chalk.gray(`   Code: ${code}`));
+    }
+    
+    if (type) {
+      console.log(chalk.gray(`   Type: ${type}`));
+    }
+    
+    if (details && Object.keys(details).length > 0) {
+      console.log(chalk.gray('   Details:'));
+      Object.entries(details).forEach(([key, value]) => {
+        console.log(chalk.gray(`     ${key}: ${value}`));
+      });
+    }
+    
+    if (suggestions && suggestions.length > 0) {
+      console.log(chalk.yellow('   Suggestions:'));
+      suggestions.forEach(suggestion => {
+        console.log(chalk.yellow(`     • ${suggestion}`));
+      });
+    }
+  }
+
+  /**
+   * Print metadata information
+   * @param {Object} metadata - Metadata to print
+   */
+  printMetadata(metadata) {
+    console.log(chalk.gray('\n--- Metadata ---'));
+    Object.entries(metadata).forEach(([key, value]) => {
+      console.log(chalk.gray(`${key}: ${value}`));
+    });
+  }
+
+  /**
+   * Format key names for display
+   * @param {string} key - Raw key name
+   * @returns {string} Formatted key name
+   */
+  formatKey(key) {
+    return key
+      .replace(/_/g, ' ')
+      .replace(/([a-z])([A-Z])/g, '$1 $2')
+      .replace(/\b\w/g, l => l.toUpperCase());
+  }
+
+  /**
+   * Format values for display
+   * @param {*} value - Raw value
+   * @returns {string} Formatted value
+   */
+  formatValue(value) {
+    if (value === null || value === undefined) {
+      return chalk.gray('null');
+    }
+    
+    if (typeof value === 'boolean') {
+      return value ? chalk.green('Yes') : chalk.red('No');
+    }
+    
+    if (typeof value === 'number') {
+      return chalk.yellow(value.toString());
+    }
+    
+    if (typeof value === 'string') {
+      if (value.length > 50) {
+        return chalk.white(value.substring(0, 47) + '...');
+      }
+      return chalk.white(value);
+    }
+    
+    if (Array.isArray(value)) {
+      return chalk.cyan(`[${value.length}]`);
+    }
+    
+    if (typeof value === 'object') {
+      return chalk.cyan('{...}');
+    }
+    
+    return chalk.white(value.toString());
+  }
+
+  /**
+   * Print progress indicator
+   * @param {string} message - Progress message
+   * @param {number} progress - Progress percentage (0-100)
+   */
+  progress(message, progress = null) {
+    if (this.jsonMode) {
+      // In JSON mode, output progress as structured data
+      const output = {
+        type: 'progress',
+        message,
+        progress,
+        timestamp: new Date().toISOString(),
+      };
+      console.error(JSON.stringify(output));
+    } else {
+      // In human mode, use simple text
+      const progressText = progress !== null ? ` [${progress}%]` : '';
+      console.error(chalk.gray(`⏳ ${message}${progressText}`));
+    }
+  }
+
+  /**
+   * Print success message
+   * @param {string} message - Success message
+   */
+  success(message) {
+    if (this.jsonMode) {
+      console.log(JSON.stringify({
+        success: true,
+        message,
+        timestamp: new Date().toISOString(),
+      }));
+    } else {
+      console.log(chalk.green(`✅ ${message}`));
+    }
+  }
+
+  /**
+   * Print warning message
+   * @param {string} message - Warning message
+   */
+  warning(message) {
+    if (this.jsonMode) {
+      console.error(JSON.stringify({
+        type: 'warning',
+        message,
+        timestamp: new Date().toISOString(),
+      }));
+    } else {
+      console.log(chalk.yellow(`⚠️  ${message}`));
+    }
+  }
+
+  /**
+   * Print error message
+   * @param {string} message - Error message
+   */
+  error(message) {
+    if (this.jsonMode) {
+      console.error(JSON.stringify({
+        success: false,
+        message,
+        timestamp: new Date().toISOString(),
+      }));
+    } else {
+      console.log(chalk.red(`❌ ${message}`));
+    }
+  }
+
+  /**
+   * Print info message
+   * @param {string} message - Info message
+   */
+  info(message) {
+    if (this.jsonMode) {
+      console.log(JSON.stringify({
+        type: 'info',
+        message,
+        timestamp: new Date().toISOString(),
+      }));
+    } else {
+      console.log(chalk.blue(`ℹ️  ${message}`));
+    }
+  }
+
+  /**
+   * Print table-like data
+   * @param {Array} headers - Table headers
+   * @param {Array} rows - Table rows
+   */
+  table(headers, rows) {
+    if (this.jsonMode) {
+      const output = {
+        type: 'table',
+        headers,
+        rows,
+        timestamp: new Date().toISOString(),
+      };
+      console.log(JSON.stringify(output, null, 2));
+    } else {
+      if (rows.length === 0) {
+        console.log(chalk.gray('No data to display'));
+        return;
+      }
+
+      // Calculate column widths
+      const colWidths = headers.map((header, i) => {
+        const maxWidth = Math.max(
+          header.length,
+          ...rows.map(row => row[i] ? row[i].toString().length : 0)
+        );
+        return Math.max(maxWidth, 8);
+      });
+
+      // Print headers
+      const headerLine = headers.map((header, i) => 
+        chalk.bold(header.padEnd(colWidths[i]))
+      ).join('  ');
+      console.log(headerLine);
+      console.log(chalk.gray('-'.repeat(headerLine.length)));
+
+      // Print rows
+      rows.forEach(row => {
+        const rowLine = row.map((cell, i) => 
+          (cell || '').toString().padEnd(colWidths[i])
+        ).join('  ');
+        console.log(rowLine);
+      });
+    }
+  }
+}
+
+// Create singleton instance
+const output = new OutputManager();
+
+/**
+ * Setup output manager instance
+ * @returns {OutputManager} Output manager instance
+ */
+function setupOutput() {
+  return output;
+}
+
+module.exports = { OutputManager, output, setupOutput };

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@intranefr/superbackend",
-  "version": "1.6.7",
+  "version": "1.7.8",
   "description": "Node.js middleware that gives your project backend superpowers",
   "main": "index.js",
   "bin": {
     "agent-chat": "src/cli/agent-chat.js",
-    "agent-list": "src/cli/agent-list.js"
+    "agent-list": "src/cli/agent-list.js",
+    "api": "src/cli/api.js",
+    "direct": "src/cli/direct.js"
   },
   "scripts": {
     "start": "node server.js",
@@ -17,7 +19,10 @@
     "build:sdk:superdemos:browser": "esbuild sdk/superdemos/browser/src/index.js --bundle --format=iife --global-name=SuperDemos --outfile=public/sdk/superdemos.iife.js",
     "test": "jest",
     "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage"
+    "test:coverage": "jest --coverage",
+    "image:deploy": "docker build -t javimosch/superbackend:latest . && docker push javimosch/superbackend:latest",
+    "api": "node src/cli/api.js",
+    "direct": "node src/cli/direct.js"
   },
   "keywords": [
     "substack",
@@ -37,6 +42,7 @@
   "license": "MIT",
   "dependencies": {
     "@aws-sdk/client-s3": "^3.0.0",
+    "@intranefr/superbackend": "^1.7.7",
     "axios": "^1.13.2",
     "bcryptjs": "^2.4.3",
     "cheerio": "^1.0.0-rc.12",

package/plugins/supercli/README.md

@@ -0,0 +1,108 @@
+# SuperBackend Skills Plugin for SuperCLI
+
+This plugin loads SuperBackend SKILL.md files into the SuperCLI skills catalog.
+
+## Installation
+
+```bash
+supercli plugins install /path/to/saas-backend/plugins/supercli
+```
+
+## Features
+
+- **Auto-discovery**: Automatically finds all SKILL.md files in the `skills/` directory
+- **No registry required**: Works as a local plugin
+- **Live sync**: Changes to skill files are picked up immediately with `supercli skills sync`
+
+## Usage
+
+### List Available Skills
+
+```bash
+supercli skills list --catalog --json
+```
+
+### Get a Specific Skill
+
+```bash
+supercli skills get superbackend:auth-github-skill --json
+```
+
+### Learn About the Plugin
+
+```bash
+supercli plugins learn superbackend
+```
+
+### Sync Skills Catalog
+
+After editing SKILL.md files, refresh the catalog:
+
+```bash
+supercli skills sync
+```
+
+## Adding New Skills
+
+1. Create a new directory under `skills/`:
+   ```bash
+   mkdir -p skills/auth-email
+   ```
+
+2. Add your SKILL.md file:
+   ```bash
+   cp /path/to/.agents/skills/auth-email/SKILL.md skills/auth-email/
+   ```
+
+3. Sync the catalog:
+   ```bash
+   supercli skills sync
+   ```
+
+4. Verify the skill is available:
+   ```bash
+   supercli skills list --catalog --json | grep auth-email
+   ```
+
+## Skill File Format
+
+Each skill is a markdown file with YAML frontmatter:
+
+```markdown
+---
+skill_name: my-skill-name
+description: Brief description of the skill
+tags: tag1,tag2,tag3
+---
+
+# Skill Content
+
+Detailed documentation...
+```
+
+## Troubleshooting
+
+### Skill Not Found After Adding
+
+Run sync to refresh the catalog:
+```bash
+supercli skills sync --json
+```
+
+### Check Plugin Status
+
+```bash
+supercli plugins show superbackend --json
+```
+
+### View Skills Index
+
+```bash
+cat ~/.supercli/skills-index.json | jq '.skills[] | select(.provider=="superbackend")'
+```
+
+## Uninstall
+
+```bash
+supercli plugins remove superbackend
+```

package/plugins/supercli/plugin.json

@@ -0,0 +1,123 @@
+{
+  "name": "superbackend",
+  "version": "1.0.0",
+  "description": "SuperBackend skills and direct CLI access - database operations, auth, RBAC, and automation",
+  "source": "local",
+  "tags": ["skills", "catalog", "superbackend", "database", "cli", "auth", "rbac"],
+  "checks": [
+    { "type": "binary", "name": "node" },
+    { "type": "binary", "name": "npm" }
+  ],
+  "learn": {
+    "file": "skills/auth-github/SKILL.md"
+  },
+  "post_install": {
+    "script": "scripts/post-install.js",
+    "runtime": "node",
+    "timeout_ms": 15000
+  },
+  "post_uninstall": {
+    "script": "scripts/post-uninstall.js",
+    "runtime": "node",
+    "timeout_ms": 15000
+  },
+  "commands": [
+    {
+      "namespace": "superbackend",
+      "resource": "waiting-list",
+      "action": "list",
+      "description": "List waiting list entries",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "npm",
+        "baseArgs": ["run", "direct", "--", "waiting-list", "list"],
+        "optionalArgs": {
+          "quiet": "--quiet",
+          "output": "--output",
+          "value": "--value"
+        },
+        "workingDirectory": "/home/jarancibia/ai/saas-backend",
+        "parseJson": false,
+        "timeout_ms": 30000
+      },
+      "args": [
+        { "name": "quiet", "type": "boolean", "required": false, "description": "Quiet mode (JSON only)" },
+        { "name": "output", "type": "string", "required": false, "description": "Output format" },
+        { "name": "value", "type": "string", "required": false, "description": "Limit results" }
+      ]
+    },
+    {
+      "namespace": "superbackend",
+      "resource": "waiting-list",
+      "action": "delete",
+      "description": "Delete waiting list entry by ID",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "npm",
+        "baseArgs": ["run", "direct", "--", "waiting-list", "delete"],
+        "positionalArgs": ["id"],
+        "optionalArgs": {
+          "quiet": "--quiet"
+        },
+        "workingDirectory": "/home/jarancibia/ai/saas-backend",
+        "parseJson": false,
+        "timeout_ms": 30000
+      },
+      "args": [
+        { "name": "id", "type": "string", "required": true, "description": "Waiting list entry ID" },
+        { "name": "quiet", "type": "boolean", "required": false, "description": "Quiet mode" }
+      ]
+    },
+    {
+      "namespace": "superbackend",
+      "resource": "waiting-list",
+      "action": "clear",
+      "description": "Clear all waiting list entries",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "npm",
+        "baseArgs": ["run", "direct", "--", "waiting-list", "clear"],
+        "optionalArgs": {
+          "quiet": "--quiet"
+        },
+        "workingDirectory": "/home/jarancibia/ai/saas-backend",
+        "parseJson": false,
+        "timeout_ms": 30000
+      },
+      "args": [
+        { "name": "quiet", "type": "boolean", "required": false, "description": "Quiet mode" }
+      ]
+    },
+    {
+      "namespace": "superbackend",
+      "resource": "direct",
+      "action": "help",
+      "description": "Show SuperBackend Direct CLI help",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "npm",
+        "baseArgs": ["run", "direct", "--", "help"],
+        "workingDirectory": "/home/jarancibia/ai/saas-backend",
+        "parseJson": false,
+        "timeout_ms": 30000
+      },
+      "args": []
+    },
+    {
+      "namespace": "superbackend",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to SuperBackend Direct CLI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "npm",
+        "baseArgs": ["run", "direct", "--"],
+        "workingDirectory": "/home/jarancibia/ai/saas-backend",
+        "passthrough": true,
+        "parseJson": false,
+        "timeout_ms": 120000
+      },
+      "args": []
+    }
+  ]
+}

package/server.js

@@ -1,4 +1,4 @@
-require('dotenv').config();
+require('dotenv').config({ path: process.env.ENV_FILE || '.env' });
 const { server } = require('./index');
 
 // Start the standalone server