@dreamlogic-ai/cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dreamlogic-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# @dreamlogic-ai/cli
+
+> **Dreamlogic AI Skill Manager** — Install, update and manage AI agent skills for your team.
+
+<p align="center">
+  <strong>by Dreamlogic-ai · MAJORNINE</strong>
+</p>
+
+---
+
+## Quick Start
+
+```bash
+npx @dreamlogic-ai/cli
+```
+
+You'll be guided through:
+1. 🔑 Entering your API key
+2. 📦 Selecting skills to install
+3. ⚙️ Configuring MCP for your AI agent
+
+## Installation
+
+```bash
+# Run without installing (recommended)
+npx @dreamlogic-ai/cli
+
+# Or install globally
+npm install -g @dreamlogic-ai/cli
+dreamlogic
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `dreamlogic` | Interactive mode (menu) |
+| `dreamlogic login` | Authenticate with API key |
+| `dreamlogic catalog` | Browse available skills |
+| `dreamlogic install [skills...]` | Install skills (multi-select) |
+| `dreamlogic update` | Check & apply updates |
+| `dreamlogic list` | List installed skills |
+| `dreamlogic rollback <skill>` | Restore previous version |
+| `dreamlogic status` | Full status overview |
+| `dreamlogic setup-mcp` | Configure MCP for AI agents |
+| `dreamlogic logout` | Clear credentials |
+
+## Non-interactive Mode (CI/CD)
+
+```bash
+# Set API key via environment variable
+export DREAMLOGIC_API_KEY=sk-user-xxxxx
+
+# Install specific skill silently
+dreamlogic install suno-cover-v5 --yes
+
+# Auto-update all skills
+dreamlogic update --yes
+```
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `DREAMLOGIC_API_KEY` | — | Override saved API key |
+| `DREAMLOGIC_SERVER` | `https://skill.dreamlogic-claw.com` | Override server URL |
+| `DREAMLOGIC_INSTALL_DIR` | `~/dreamlogic-skills` | Override install directory |
+| `DREAMLOGIC_NO_COLOR` | — | Disable colored output |
+| `CI` | — | CI mode (disable interactive prompts) |
+
+## Supported AI Agents
+
+The `setup-mcp` command can auto-configure:
+
+- ✅ Claude Desktop
+- ✅ Claude CLI
+- ✅ Cursor
+- 📋 Codex CLI (manual guide)
+- 📋 Cline (manual guide)
+
+## Security
+
+- API keys stored with file permission `600` (owner-only)
+- All downloads verified with SHA256 checksums
+- ZIP extraction uses `yauzl` (safe against Zip Slip attacks)
+- Atomic install: staging → rename (no partial installs)
+- No secrets embedded in CLI code
+
+## Requirements
+
+- Node.js ≥ 18
+- A valid Dreamlogic API key
+
+## License
+
+MIT © Dreamlogic-ai

package/dist/commands/catalog.d.ts

@@ -0,0 +1 @@
+export declare function catalogCommand(): Promise<void>;

package/dist/commands/catalog.js

@@ -0,0 +1,39 @@
+/**
+ * catalog command — list available skills from server
+ */
+import { ApiClient } from "../lib/api-client.js";
+import { getServer } from "../lib/config.js";
+import { ui } from "../lib/ui.js";
+import { requireAuth } from "./helpers.js";
+export async function catalogCommand() {
+    const apiKey = requireAuth();
+    if (!apiKey)
+        return;
+    const client = new ApiClient(getServer(), apiKey);
+    const spinner = ui.spinner("Fetching skill catalog...");
+    spinner.start();
+    try {
+        const skills = await client.listSkills();
+        spinner.succeed(`  ${skills.length} skill(s) available`);
+        console.log();
+        if (skills.length === 0) {
+            ui.info("No skills available yet. Check back soon!");
+            return;
+        }
+        for (const s of skills) {
+            const ver = s.latest_version ? ui.dim(` v${s.latest_version.replace(/^v/, "")}`) : "";
+            const size = s.package_size ? ui.dim(` · ${ui.fileSize(s.package_size)}`) : "";
+            const status = s.status === "active" ? ui.success("●") :
+                s.status === "deprecated" ? ui.warn("●") : ui.dim("●");
+            console.log(`  ${status} ${ui.brand(s.name)}${ver}${size}`);
+            console.log(`    ${ui.dim(s.description)}`);
+            console.log(`    ${ui.dim("ID: " + s.id)}`);
+            console.log();
+        }
+    }
+    catch (err) {
+        spinner.fail("  Failed to fetch catalog");
+        ui.err(err.message);
+        process.exitCode = 1;
+    }
+}

package/dist/commands/helpers.d.ts

@@ -0,0 +1,2 @@
+/** Ensure user is authenticated; return key or null */
+export declare function requireAuth(): string | null;

package/dist/commands/helpers.js

@@ -0,0 +1,15 @@
+/**
+ * Shared helpers for commands
+ */
+import { getApiKey } from "../lib/config.js";
+import { ui } from "../lib/ui.js";
+/** Ensure user is authenticated; return key or null */
+export function requireAuth() {
+    const key = getApiKey();
+    if (!key) {
+        ui.err("Not logged in. Run: dreamlogic login");
+        process.exitCode = 1;
+        return null;
+    }
+    return key;
+}

package/dist/commands/install.d.ts

@@ -0,0 +1,4 @@
+export declare function installCommand(skillIds: string[], opts: {
+    yes?: boolean;
+    fromFile?: string;
+}): Promise<void>;

package/dist/commands/install.js

@@ -0,0 +1,138 @@
+/**
+ * install command — download and install skills
+ * Supports: interactive multi-select, single skill by name, --from-file
+ */
+import { checkbox, confirm } from "@inquirer/prompts";
+import { ApiClient } from "../lib/api-client.js";
+import { getServer, getInstallDir, loadInstalled } from "../lib/config.js";
+import { installSkill } from "../lib/installer.js";
+import { ui } from "../lib/ui.js";
+import { requireAuth } from "./helpers.js";
+import chalk from "chalk";
+export async function installCommand(skillIds, opts) {
+    const apiKey = requireAuth();
+    if (!apiKey)
+        return;
+    const client = new ApiClient(getServer(), apiKey);
+    // Fetch catalog
+    const spinner = ui.spinner("Fetching available skills...");
+    spinner.start();
+    let skills;
+    try {
+        skills = await client.listSkills();
+        spinner.succeed(`  ${skills.length} skill(s) available`);
+    }
+    catch (err) {
+        spinner.fail("  Failed to connect");
+        ui.err(err.message);
+        process.exitCode = 1;
+        return;
+    }
+    const installed = loadInstalled();
+    // If no specific skill IDs given, show interactive selector
+    let selectedIds;
+    if (skillIds.length === 0) {
+        if (skills.length === 0) {
+            ui.info("No skills available yet.");
+            return;
+        }
+        const choices = skills.map((s) => {
+            const isInstalled = !!installed[s.id];
+            const ver = s.latest_version || "unknown";
+            const currentVer = installed[s.id]?.version;
+            let tag = "";
+            if (!isInstalled) {
+                tag = chalk.green(" [NEW]");
+            }
+            else if (currentVer && s.latest_version && currentVer !== s.latest_version) {
+                tag = chalk.yellow(` [UPDATE: ${currentVer} → ${s.latest_version}]`);
+            }
+            else {
+                tag = chalk.dim(" [INSTALLED]");
+            }
+            return {
+                name: `${s.name} (${ver}) — ${s.description}${tag}`,
+                value: s.id,
+                checked: !isInstalled, // auto-check new skills
+            };
+        });
+        console.log();
+        selectedIds = await checkbox({
+            message: "Select skills to install (Space to select, Enter to confirm):",
+            choices,
+        });
+        if (selectedIds.length === 0) {
+            ui.info("Nothing selected.");
+            return;
+        }
+    }
+    else {
+        // Validate requested skill IDs
+        const invalid = skillIds.filter((id) => !skills.find((s) => s.id === id));
+        if (invalid.length > 0) {
+            ui.err(`Unknown skill(s): ${invalid.join(", ")}`);
+            ui.info("Available: " + skills.map((s) => s.id).join(", "));
+            process.exitCode = 1;
+            return;
+        }
+        selectedIds = skillIds;
+    }
+    // R1-12: --from-file only works with single skill
+    if (opts.fromFile && selectedIds.length > 1) {
+        ui.err("--from-file can only be used with a single skill.");
+        process.exitCode = 1;
+        return;
+    }
+    // Confirm
+    if (!opts.yes) {
+        console.log();
+        ui.header("Installation Plan");
+        for (const id of selectedIds) {
+            const s = skills.find((s) => s.id === id);
+            if (!s)
+                continue; // R1-19: guard
+            const ver = s.latest_version || "unknown";
+            const size = s.package_size ? ui.fileSize(s.package_size) : "unknown";
+            ui.line(`  📦 ${chalk.bold(s.name)} ${ver} (${size})`);
+        }
+        ui.line(`  📂 Install to: ${getInstallDir()}`);
+        console.log();
+        const ok = await confirm({ message: "Proceed?", default: true });
+        if (!ok) {
+            ui.info("Cancelled.");
+            return;
+        }
+    }
+    // Install each
+    let successCount = 0;
+    for (const id of selectedIds) {
+        const s = skills.find((s) => s.id === id);
+        if (!s) {
+            ui.err(`Skill '${id}' no longer in catalog`);
+            continue;
+        } // R1-19
+        console.log();
+        ui.header(`Installing ${s.name}`);
+        try {
+            const result = await installSkill(client, s.id, s.package_file || `${s.id}-${s.latest_version}.zip`, s.package_sha256, s.latest_version || "unknown", { fromFile: opts.fromFile });
+            ui.ok(`Installed to ${result.path}`);
+            successCount++;
+        }
+        catch (err) {
+            ui.err(`Failed to install ${s.name}: ${err.message}`);
+        }
+    }
+    console.log();
+    if (successCount === selectedIds.length) {
+        ui.ok(`All ${successCount} skill(s) installed successfully! 🎉`);
+    }
+    else {
+        ui.warning(`${successCount}/${selectedIds.length} installed. Check errors above.`);
+    }
+    // Suggest MCP setup
+    if (successCount > 0) {
+        console.log();
+        ui.info("To configure MCP for your AI agent, run:");
+        ui.line(`  ${chalk.cyan("dreamlogic setup-mcp")}`);
+    }
+}

package/dist/commands/list.d.ts

@@ -0,0 +1 @@
+export declare function listCommand(): void;

package/dist/commands/list.js

@@ -0,0 +1,31 @@
+/**
+ * list command — show locally installed skills
+ */
+import { loadInstalled, getInstallDir } from "../lib/config.js";
+import { ui } from "../lib/ui.js";
+import chalk from "chalk";
+export function listCommand() {
+    const installed = loadInstalled();
+    const entries = Object.entries(installed);
+    if (entries.length === 0) {
+        ui.info("No skills installed. Run: dreamlogic install");
+        return;
+    }
+    console.log();
+    ui.line(`📂 Install directory: ${getInstallDir()}`);
+    console.log();
+    for (const [id, info] of entries) {
+        ui.line(`  ${chalk.green("●")} ${chalk.bold(id)}`);
+        ui.table([
+            ["Version", info.version],
+            ["Installed", new Date(info.installed_at).toLocaleString()],
+            ["Path", info.path],
+            ["SHA256", info.sha256.slice(0, 16) + "..."],
+        ]);
+        if (info.previous_version) {
+            ui.line(`    ${ui.dim(`Previous: ${info.previous_version}`)}`);
+        }
+        console.log();
+    }
+    ui.line(`  Total: ${entries.length} skill(s)`);
+}

package/dist/commands/login.d.ts

@@ -0,0 +1,3 @@
+export declare function loginCommand(opts: {
+    key?: string;
+}): Promise<void>;

package/dist/commands/login.js

@@ -0,0 +1,70 @@
+/**
+ * login command — authenticate and save API key
+ */
+import { password, confirm } from "@inquirer/prompts";
+import { ApiClient, ApiError } from "../lib/api-client.js";
+import { loadConfig, saveConfig, getApiKey, getServer, maskKey, getDefaultInstallDir, } from "../lib/config.js";
+import { DEFAULT_SERVER } from "../types.js";
+import { ui } from "../lib/ui.js";
+const KEY_RE = /^sk-(admin|user)-[a-f0-9]{16,}$/;
+export async function loginCommand(opts) {
+    const existingKey = getApiKey();
+    if (existingKey && !opts.key) {
+        ui.info(`Already logged in as ${maskKey(existingKey)}`);
+        const relogin = await confirm({
+            message: "Re-authenticate with a different key?",
+            default: false,
+        });
+        if (!relogin)
+            return;
+    }
+    let apiKey = opts.key || "";
+    // R1-04: Warn about key visibility in args/history
+    if (opts.key) {
+        ui.warning("Key passed via CLI argument — it may be visible in shell history.");
+        ui.info("Prefer: dreamlogic login (interactive) or DREAMLOGIC_API_KEY env var");
+    }
+    if (!apiKey) {
+        apiKey = await password({
+            message: "Enter your Dreamlogic API Key:",
+            mask: "*",
+            validate: (v) => KEY_RE.test(v) || "Key must match format: sk-user-xxxx... or sk-admin-xxxx...",
+        });
+    }
+    if (!KEY_RE.test(apiKey)) {
+        ui.err("Invalid key format. Expected: sk-user-xxxx... or sk-admin-xxxx...");
+        process.exitCode = 1;
+        return;
+    }
+    const server = getServer();
+    const spinner = ui.spinner("Verifying key...");
+    spinner.start();
+    try {
+        const client = new ApiClient(server, apiKey);
+        const user = await client.me();
+        spinner.succeed(`  Welcome, ${ui.brand(user.name)}! (${user.role})`);
+        const config = loadConfig() || { api_key: "", server: DEFAULT_SERVER, install_dir: getDefaultInstallDir() };
+        config.api_key = apiKey;
+        config.server = server;
+        if (!config.install_dir)
+            config.install_dir = getDefaultInstallDir();
+        saveConfig(config);
+        ui.ok("Configuration saved to ~/.dreamlogic/config.json");
+    }
+    catch (err) {
+        spinner.fail("  Authentication failed");
+        if (err instanceof ApiError) {
+            if (err.status === 401) {
+                ui.err("Invalid or disabled API key. Please check your key and try again.");
+            }
+            else {
+                ui.err(`Server error: ${err.message}`);
+            }
+        }
+        else {
+            ui.err(`Connection failed: ${err.message}`);
+            ui.info(`Server: ${server}`);
+        }
+        process.exitCode = 1;
+    }
+}

package/dist/commands/logout.d.ts

@@ -0,0 +1 @@
+export declare function logoutCommand(): Promise<void>;

package/dist/commands/logout.js

@@ -0,0 +1,19 @@
+/**
+ * logout command — clear saved credentials
+ */
+import { confirm } from "@inquirer/prompts";
+import { clearConfig, maskKey, getApiKey } from "../lib/config.js";
+import { ui } from "../lib/ui.js";
+export async function logoutCommand() {
+    const key = getApiKey();
+    if (!key) {
+        ui.info("Not logged in.");
+        return;
+    }
+    ui.info(`Current key: ${maskKey(key)}`);
+    const ok = await confirm({ message: "Clear saved credentials?", default: true });
+    if (ok) {
+        clearConfig();
+        ui.ok("Credentials cleared.");
+    }
+}

package/dist/commands/rollback.d.ts

@@ -0,0 +1 @@
+export declare function rollbackCommand(skillId: string): Promise<void>;

package/dist/commands/rollback.js

@@ -0,0 +1,40 @@
+/**
+ * rollback command — restore previous version of a skill (D-13)
+ */
+import { confirm } from "@inquirer/prompts";
+import { rollbackSkill } from "../lib/installer.js";
+import { loadInstalled } from "../lib/config.js";
+import { ui } from "../lib/ui.js";
+export async function rollbackCommand(skillId) {
+    const installed = loadInstalled();
+    if (!installed[skillId]) {
+        ui.err(`Skill '${skillId}' is not installed.`);
+        process.exitCode = 1;
+        return;
+    }
+    const info = installed[skillId];
+    if (!info.previous_version) {
+        ui.err(`No previous version available for rollback.`);
+        ui.info(`Current version: ${info.version}`);
+        return;
+    }
+    ui.info(`Current: ${info.version}`);
+    ui.info(`Rollback to: ${info.previous_version}`);
+    const ok = await confirm({ message: "Proceed with rollback?", default: true });
+    if (!ok) {
+        ui.info("Cancelled.");
+        return;
+    }
+    const spinner = ui.spinner("Rolling back...");
+    spinner.start();
+    const success = rollbackSkill(skillId);
+    if (success) {
+        spinner.succeed(`  Rolled back to previous version`);
+        ui.ok("Rollback complete.");
+    }
+    else {
+        spinner.fail("  Rollback failed");
+        ui.err("No backup found. Manual restore required.");
+        process.exitCode = 1;
+    }
+}

package/dist/commands/setup-mcp.d.ts

@@ -0,0 +1,3 @@
+export declare function setupMcpCommand(opts: {
+    dryRun?: boolean;
+}): Promise<void>;