zammy 1.2.1 → 1.3.2

package/dist/plugins.d.ts

@@ -0,0 +1,168 @@
+interface Command {
+    name: string;
+    description: string;
+    usage: string;
+    execute: (args: string[]) => Promise<void>;
+}
+
+interface PluginManifest {
+    name: string;
+    version: string;
+    main: string;
+    commands: string[];
+    zammy: {
+        minVersion: string;
+        maxVersion?: string;
+    };
+    displayName?: string;
+    description?: string;
+    author?: string;
+    license?: string;
+    homepage?: string;
+    repository?: string;
+    permissions?: PluginPermissions;
+}
+interface PluginPermissions {
+    shell?: boolean;
+    filesystem?: boolean | string[];
+    network?: boolean | string[];
+    env?: boolean | string[];
+}
+interface PluginAPI {
+    registerCommand(command: Command): void;
+    registerCommands(commands: Command[]): void;
+    ui: PluginUI;
+    storage: PluginStorage;
+    log: PluginLogger;
+    context: PluginContext;
+    shell?: PluginShell;
+}
+interface PluginUI {
+    theme: {
+        primary: (text: string) => string;
+        secondary: (text: string) => string;
+        accent: (text: string) => string;
+        success: (text: string) => string;
+        warning: (text: string) => string;
+        error: (text: string) => string;
+        info: (text: string) => string;
+        dim: (text: string) => string;
+        gradient: (text: string) => string;
+    };
+    symbols: {
+        check: string;
+        cross: string;
+        star: string;
+        arrow: string;
+        bullet: string;
+        folder: string;
+        file: string;
+        warning: string;
+        info: string;
+        rocket: string;
+        sparkles: string;
+    };
+    box: (content: string, options?: {
+        title?: string;
+        padding?: number;
+    }) => string;
+    progressBar: (current: number, total: number, width?: number) => string;
+}
+interface PluginStorage {
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T): void;
+    delete(key: string): void;
+    clear(): void;
+    getAll(): Record<string, unknown>;
+}
+interface PluginLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+}
+interface PluginContext {
+    pluginName: string;
+    pluginVersion: string;
+    zammyVersion: string;
+    dataDir: string;
+    cwd: string;
+}
+interface PluginShell {
+    exec(command: string, options?: {
+        timeout?: number;
+    }): string;
+    spawn(command: string, args?: string[]): Promise<{
+        stdout: string;
+        stderr: string;
+        code: number;
+    }>;
+}
+interface ZammyPlugin {
+    activate(api: PluginAPI): Promise<void> | void;
+    deactivate?(): Promise<void> | void;
+}
+interface LoadedPlugin {
+    manifest: PluginManifest;
+    instance: ZammyPlugin;
+    path: string;
+    state: PluginState;
+}
+type PluginState = 'discovered' | 'loaded' | 'active' | 'error';
+interface PluginError {
+    pluginName: string;
+    error: Error;
+    phase: 'discovery' | 'load' | 'activate' | 'execute';
+}
+
+declare function ensurePluginsDir(): void;
+declare function getPluginsDir(): string;
+declare function discoverPlugins(): Promise<PluginManifest[]>;
+declare function loadPlugin(name: string): Promise<LoadedPlugin | null>;
+declare function unloadPlugin(name: string): Promise<boolean>;
+declare function getDiscoveredPlugins(): PluginManifest[];
+declare function getLoadedPlugins(): LoadedPlugin[];
+declare function isPluginLoaded(name: string): boolean;
+declare function getPluginPath(name: string): string | undefined;
+declare function initPluginLoader(): Promise<void>;
+
+declare function createPluginAPI(manifest: PluginManifest, pluginPath: string): PluginAPI;
+
+declare function createPluginStorage(pluginName: string, dataDir: string): PluginStorage;
+
+declare function validateManifest(manifest: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+declare function checkConflicts(manifest: PluginManifest): {
+    hasConflicts: boolean;
+    conflicts: string[];
+};
+declare function formatPermissions(manifest: PluginManifest): string[];
+declare function installFromLocal(sourcePath: string): Promise<{
+    success: boolean;
+    error?: string;
+    manifest?: PluginManifest;
+}>;
+declare function installFromNpm(packageName: string): Promise<{
+    success: boolean;
+    error?: string;
+    manifest?: PluginManifest;
+}>;
+declare function installFromGithub(repo: string): Promise<{
+    success: boolean;
+    error?: string;
+    manifest?: PluginManifest;
+}>;
+declare function installFromGit(url: string): Promise<{
+    success: boolean;
+    error?: string;
+    manifest?: PluginManifest;
+}>;
+declare function removePlugin(name: string): {
+    success: boolean;
+    error?: string;
+};
+declare function detectSourceType(source: string): 'local' | 'npm' | 'github' | 'git' | 'unknown';
+
+export { type LoadedPlugin, type PluginAPI, type PluginContext, type PluginError, type PluginLogger, type PluginManifest, type PluginPermissions, type PluginShell, type PluginState, type PluginStorage, type PluginUI, type ZammyPlugin, checkConflicts, createPluginAPI, createPluginStorage, detectSourceType, discoverPlugins, ensurePluginsDir, formatPermissions, getDiscoveredPlugins, getLoadedPlugins, getPluginPath, getPluginsDir, initPluginLoader, installFromGit, installFromGithub, installFromLocal, installFromNpm, isPluginLoaded, loadPlugin, removePlugin, unloadPlugin, validateManifest };

package/dist/plugins.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import {
+  checkConflicts,
+  createPluginAPI,
+  createPluginStorage,
+  detectSourceType,
+  discoverPlugins,
+  ensurePluginsDir,
+  formatPermissions,
+  getDiscoveredPlugins,
+  getLoadedPlugins,
+  getPluginPath,
+  getPluginsDir,
+  initPluginLoader,
+  installFromGit,
+  installFromGithub,
+  installFromLocal,
+  installFromNpm,
+  isPluginLoaded,
+  loadPlugin,
+  removePlugin,
+  unloadPlugin,
+  validateManifest
+} from "./chunk-LLLEINP6.js";
+export {
+  checkConflicts,
+  createPluginAPI,
+  createPluginStorage,
+  detectSourceType,
+  discoverPlugins,
+  ensurePluginsDir,
+  formatPermissions,
+  getDiscoveredPlugins,
+  getLoadedPlugins,
+  getPluginPath,
+  getPluginsDir,
+  initPluginLoader,
+  installFromGit,
+  installFromGithub,
+  installFromLocal,
+  installFromNpm,
+  isPluginLoaded,
+  loadPlugin,
+  removePlugin,
+  unloadPlugin,
+  validateManifest
+};

package/package.json

@@ -1,8 +1,22 @@
 {
   "name": "zammy",
-  "version": "1.2.1",
+  "version": "1.3.2",
   "description": "A feature-packed CLI with utilities, dev tools, and a bit of fun",
   "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "workspaces": [
+    "packages/plugins/*"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./plugins": {
+      "types": "./dist/plugins.d.ts",
+      "import": "./dist/plugins.js"
+    }
+  },
   "bin": {
     "zammy": "./dist/index.js"
   },
@@ -18,8 +32,12 @@
   "keywords": [
     "cli",
     "terminal",
+    "developer-tools",
+    "productivity",
     "ascii-art",
-    "utility"
+    "interactive",
+    "cross-platform",
+    "utilities"
   ],
   "author": "Aayush Adhikari",
   "license": "MIT",

package/packages/plugins/docker/README.md

@@ -0,0 +1,141 @@
+# zammy-plugin-docker
+
+Docker container management with pretty output.
+
+## Installation
+
+```bash
+/plugin install zammy-plugin-docker
+```
+
+## Requirements
+
+- Docker must be installed and running
+- Docker daemon must be accessible (may require sudo on Linux)
+
+## Commands
+
+### `/docker ps`
+
+List running containers. Use `-a` flag to show all containers.
+
+```bash
+/docker ps
+
+  RUNNING CONTAINERS
+
+  ID            NAME                IMAGE                    STATUS
+  ──────────────────────────────────────────────────────────────────────
+  abc123def456  my-app              node:18                  ✔ Up 2 hours
+  789xyz012abc  postgres            postgres:15              ✔ Up 3 days
+
+  Total: 2 containers
+```
+
+### `/docker images`
+
+List all Docker images.
+
+```bash
+/docker images
+
+  DOCKER IMAGES
+
+  REPOSITORY                    TAG            SIZE        AGE
+  ─────────────────────────────────────────────────────────────────
+  node                          18             950MB       2 days ago
+  postgres                      15             380MB       1 month ago
+  nginx                         latest         140MB       3 days ago
+
+  Total: 3 images
+```
+
+### `/docker logs <container>`
+
+View container logs (last 20 lines by default).
+
+```bash
+/docker logs my-app
+
+  Logs for my-app (last 20 lines)
+  ──────────────────────────────────────────────
+
+  [INFO] Server starting on port 3000
+  [INFO] Database connected
+  [WARN] Cache miss for user:123
+```
+
+### `/docker stats`
+
+Show real-time resource usage for running containers.
+
+```bash
+/docker stats
+
+  CONTAINER STATS
+
+  NAME                CPU       MEMORY              NET I/O
+  ────────────────────────────────────────────────────────────
+  my-app              2.5%      125MiB / 8GiB       1.2MB / 500KB
+  postgres            0.8%      250MiB / 8GiB       800KB / 1.5MB
+```
+
+### `/docker prune`
+
+Clean up unused Docker resources.
+
+```bash
+/docker prune
+
+  ✔ Cleanup complete
+
+  Space reclaimed: 2.5GB
+
+  Tip: Use /docker prune -a to remove unused images too
+```
+
+Flags:
+- `-a` or `--all` - Remove all unused images, not just dangling ones
+- `--volumes` - Also remove unused volumes
+
+### `/docker inspect <container>`
+
+Show detailed information about a container.
+
+```bash
+/docker inspect my-app
+
+  CONTAINER DETAILS
+
+  Name:    my-app
+  ID:      abc123def456
+  Image:   node:18
+  Status:  running
+  Created: 2024-01-15T10:30:00Z
+  IP:      172.17.0.2
+
+  Ports:
+    3000/tcp → 3000
+
+  Environment: (5 vars)
+    NODE_ENV
+    PORT
+    DATABASE_URL
+    ... and 2 more
+```
+
+## Error Handling
+
+The plugin gracefully handles:
+- Docker not installed
+- Docker daemon not running
+- Container not found
+- Permission issues
+
+## Permissions
+
+This plugin requires shell access to run Docker commands.
+
+## License
+
+MIT

package/packages/plugins/docker/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { ZammyPlugin } from 'zammy/plugins';
+declare const plugin: ZammyPlugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/packages/plugins/docker/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,eAAe,CAAC;AAuN5D,QAAA,MAAM,MAAM,EAAE,WAmSb,CAAC;AAEF,eAAe,MAAM,CAAC"}