@trikhub/cli 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Muffles
+
+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,389 @@
+# TrikHub CLI
+
+The official command-line tool for [TrikHub](https://trikhub.com) - install and manage AI skills (triks) for your applications.
+
+## Installation
+
+```bash
+npm install -g @trikhub/cli
+```
+
+## Quick Start
+
+```bash
+# Search for triks
+trik search article
+
+# Install a trik
+trik install @acme/article-search
+
+# List installed triks
+trik list
+
+# Get trik info
+trik info @acme/article-search
+
+# Upgrade a trik
+trik upgrade @acme/article-search
+
+# Uninstall a trik
+trik uninstall @acme/article-search
+```
+
+## Commands
+
+### `trik install <name>`
+
+Install a trik from the registry.
+
+```bash
+# Install latest version
+trik install @scope/trik-name
+
+# Install specific version
+trik install @scope/trik-name@1.2.3
+
+# Or use --version flag
+trik install @scope/trik-name --version 1.2.3
+```
+
+The install process:
+1. Resolves configuration (see [Local vs Global Configuration](#local-vs-global-configuration))
+2. Fetches trik metadata from the registry
+3. Downloads the tarball from GitHub Releases
+4. Extracts to the configured triks directory
+5. **Validates** the trik (manifest structure, security rules)
+6. Updates the lockfile
+
+If validation fails, the trik is removed and installation aborts.
+
+### `trik search <query>`
+
+Search for triks in the registry.
+
+```bash
+trik search article
+trik search "web scraping"
+```
+
+### `trik list`
+
+List all installed triks.
+
+```bash
+trik list
+trik list --json  # Output as JSON
+```
+
+### `trik info <name>`
+
+Show detailed information about a trik.
+
+```bash
+trik info @acme/article-search
+trik info @acme/article-search --json  # Output as JSON
+```
+
+### `trik uninstall <name>`
+
+Remove an installed trik.
+
+```bash
+trik uninstall @acme/article-search
+```
+
+### `trik upgrade [name]`
+
+Upgrade installed triks to their latest versions.
+
+```bash
+# Upgrade all triks
+trik upgrade
+
+# Upgrade specific trik
+trik upgrade @acme/article-search
+
+# Force reinstall even if up to date
+trik upgrade --force
+```
+
+## Authentication
+
+### `trik login`
+
+Authenticate with TrikHub using your GitHub account.
+
+```bash
+trik login
+```
+
+This starts a device authorization flow:
+1. Opens a browser to GitHub
+2. Displays a code to enter
+3. After authorization, your session is saved locally
+
+### `trik logout`
+
+Remove saved authentication.
+
+```bash
+trik logout
+```
+
+### `trik whoami`
+
+Show the currently authenticated user.
+
+```bash
+trik whoami
+```
+
+## Publishing
+
+### `trik publish`
+
+Publish a trik to the TrikHub registry.
+
+```bash
+# From inside your trik directory
+trik publish
+
+# Or specify a directory
+trik publish --directory /path/to/my-trik
+
+# Publish a specific version
+trik publish --tag 1.2.0
+
+# Skip GitHub release creation (create it manually)
+trik publish --skip-release
+```
+
+**Prerequisites:**
+
+- Logged in with `trik login`
+- GitHub CLI (`gh`) installed and authenticated
+- Write access to the GitHub repository
+
+### Publishing Flow
+
+The CLI will:
+
+1. Validate your trik structure (manifest.json, trikhub.json, dist/)
+2. Create a tarball with required files
+3. Compute SHA-256 hash for integrity verification
+4. Create a GitHub Release with the tarball attached
+5. Register the trik with the TrikHub registry
+
+### Required Files
+
+```
+your-trik/
+├── manifest.json      # Trik manifest (required)
+├── trikhub.json       # Registry metadata (required)
+├── dist/
+│   └── graph.js       # Compiled entry point (required)
+└── README.md          # Documentation (recommended)
+```
+
+### Manifest Requirements
+
+Your `manifest.json` must pass validation:
+
+- Use `enum`, `const`, or `pattern` to constrain strings in `agentDataSchema`
+- Template mode requires `responseTemplates`
+- Passthrough mode requires `userContentSchema`
+
+See the [SAAAS SDK documentation](https://github.com/trikhub/saaas-sdk) for manifest schema details.
+
+## Trik Names
+
+Triks use scoped names similar to npm:
+
+```
+@scope/trik-name
+@scope/trik-name@version
+```
+
+- **Scope**: Maps to a GitHub user or organization (e.g., `@acme`)
+- **Name**: The trik name (e.g., `article-search`)
+- **Version**: Optional semver version (e.g., `1.2.3`)
+
+**Note:** All trik names are normalized to lowercase. `@Acme/Article-Search` becomes `@acme/article-search`.
+
+## Local vs Global Configuration
+
+The CLI supports both **local** (project-level) and **global** (user-level) configurations. This allows you to have project-specific trik installations or share triks across all projects.
+
+### Configuration Resolution
+
+When you run a command like `trik install`, the CLI resolves configuration in this order:
+
+1. **Local config**: Checks for `.trikhub/config.json` in the current directory
+2. **Global config**: Falls back to `~/.trikhub/config.json` in your home directory
+3. **Setup prompt**: If neither exists, prompts you to choose where to set up
+
+```
+$ trik install @acme/article-search
+
+No TrikHub configuration found.
+Triks need a place to be installed.
+
+? Where would you like to set up TrikHub?
+❯ Global (~/.trikhub)      - Available to all projects
+  Local (./.trikhub)       - Project-specific configuration
+```
+
+### Global Configuration (Default)
+
+Triks are installed in your home directory and available to all projects:
+
+```
+~/.trikhub/
+├── config.json      # CLI configuration
+├── triks.lock       # Lockfile tracking installed versions
+└── triks/           # Installed triks
+    └── @scope/trik-name/
+```
+
+### Local Configuration
+
+Triks are installed in the current project directory. Useful for:
+
+- Project-specific trik versions
+- Sharing trik configurations with your team (commit `.trikhub/` to git)
+- Isolated environments
+
+```
+./your-project/
+└── .trikhub/
+    ├── config.json      # Project-specific configuration
+    ├── triks.lock       # Project lockfile
+    └── triks/           # Project-specific triks
+        └── @scope/trik-name/
+```
+
+### Switching Between Scopes
+
+The CLI automatically detects which scope to use based on the presence of `.trikhub/config.json` in the current directory:
+
+```bash
+# In a project with local config
+$ trik list
+Installed triks (2) (local: /path/to/project/.trikhub):
+  ● @acme/article-search v1.0.0
+
+# In a directory without local config (uses global)
+$ cd ~
+$ trik list
+Installed triks (5) (global):
+  ● @acme/other-trik v2.0.0
+```
+
+### Initializing a Local Config
+
+If you have a global config but want to set up a local one for a project:
+
+```bash
+$ trik install @scope/some-trik
+# When prompted "Use global configuration?", select "No"
+# This will initialize a local .trikhub/ directory
+```
+
+## File Locations
+
+### Global (Default)
+
+| Path | Description |
+|------|-------------|
+| `~/.trikhub/config.json` | CLI configuration |
+| `~/.trikhub/triks.lock` | Lockfile tracking installed versions |
+| `~/.trikhub/triks/` | Installed triks directory |
+
+### Local (Project-Level)
+
+| Path | Description |
+|------|-------------|
+| `./.trikhub/config.json` | Project-specific configuration |
+| `./.trikhub/triks.lock` | Project lockfile |
+| `./.trikhub/triks/` | Project-specific triks |
+
+## Validation
+
+Every installed trik is validated to ensure security:
+
+- **Manifest structure** - Required fields, valid schemas
+- **Privilege separation** - No unconstrained strings in `agentDataSchema`
+- **Entry point** - Compiled code exists at specified path
+- **Response mode compliance** - Template mode has templates, passthrough has userContentSchema
+
+Triks that fail validation are rejected to prevent prompt injection vulnerabilities.
+
+## Configuration
+
+### Registry URL
+
+By default, the CLI connects to `https://api.trikhub.com`. For development, you can override this:
+
+```bash
+# Environment variable (highest priority)
+export TRIKHUB_REGISTRY=http://localhost:3000
+
+# Or edit your config.json (local or global)
+{
+  "registry": "http://localhost:3000"
+}
+```
+
+### Config File
+
+The `config.json` file (either local `.trikhub/config.json` or global `~/.trikhub/config.json`) stores:
+
+```json
+{
+  "registry": "https://api.trikhub.com",
+  "triksDirectory": ".trikhub/triks",
+  "analytics": true,
+  "authToken": "...",
+  "authExpiresAt": "2026-03-09T11:24:12.401Z",
+  "publisherUsername": "your-github-username"
+}
+```
+
+| Field | Description |
+| ----- | ----------- |
+| `registry` | TrikHub registry URL |
+| `triksDirectory` | Where triks are installed (relative to config location for local) |
+| `analytics` | Whether to send anonymous download analytics |
+| `authToken` | Authentication token (set by `trik login`) |
+| `authExpiresAt` | Token expiration timestamp |
+| `publisherUsername` | Authenticated GitHub username |
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/trikhub/cli
+cd cli
+
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Run locally
+node dist/cli.js --help
+
+# With local registry
+TRIKHUB_REGISTRY=http://localhost:3000 node dist/cli.js search article
+```
+
+## Related Projects
+
+- **[@trikhub/registry](https://github.com/trikhub/registry)** - The TrikHub registry service
+- **[SAAAS SDK](https://github.com/trikhub/saaas-sdk)** - SDK for building AI skills
+- **[trikhub.com](https://trikhub.com)** - Web interface for browsing triks
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * TrikHub CLI
+ *
+ * Command-line interface for managing AI triks.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/dist/cli.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+/**
+ * TrikHub CLI
+ *
+ * Command-line interface for managing AI triks.
+ */
+import { Command } from 'commander';
+import { installCommand } from './commands/install.js';
+import { listCommand } from './commands/list.js';
+import { searchCommand } from './commands/search.js';
+import { infoCommand } from './commands/info.js';
+import { uninstallCommand } from './commands/uninstall.js';
+import { loginCommand, logoutCommand, whoamiCommand } from './commands/login.js';
+import { publishCommand } from './commands/publish.js';
+import { upgradeCommand, upgradeAllCommand } from './commands/upgrade.js';
+import { syncCommand } from './commands/sync.js';
+const program = new Command();
+program
+    .name('trik')
+    .description('TrikHub CLI - Teaching AI new triks')
+    .version('0.1.0');
+// Install command
+program
+    .command('install <trik>')
+    .alias('i')
+    .description('Install a trik (e.g., trik install @acme/article-search)')
+    .option('-v, --version <version>', 'Install a specific version')
+    .action(installCommand);
+// Uninstall command
+program
+    .command('uninstall <trik>')
+    .alias('rm')
+    .alias('remove')
+    .description('Uninstall a trik')
+    .action(uninstallCommand);
+// List command
+program
+    .command('list')
+    .alias('ls')
+    .description('List installed triks')
+    .option('-j, --json', 'Output as JSON')
+    .action(listCommand);
+// Search command
+program
+    .command('search <query>')
+    .alias('s')
+    .description('Search for triks in the registry')
+    .option('-j, --json', 'Output as JSON')
+    .option('-l, --limit <number>', 'Limit results', '10')
+    .action(searchCommand);
+// Info command
+program
+    .command('info <trik>')
+    .description('Show detailed information about a trik')
+    .option('-j, --json', 'Output as JSON')
+    .action(infoCommand);
+// Login command
+program
+    .command('login')
+    .description('Authenticate with GitHub')
+    .action(loginCommand);
+// Logout command
+program
+    .command('logout')
+    .description('Remove saved authentication')
+    .action(logoutCommand);
+// Whoami command
+program
+    .command('whoami')
+    .description('Show current authenticated user')
+    .action(whoamiCommand);
+// Publish command
+program
+    .command('publish')
+    .description('Publish a trik to the registry')
+    .option('-d, --directory <path>', 'Trik directory to publish', '.')
+    .option('-t, --tag <version>', 'Version tag (default: from manifest)')
+    .option('--skip-release', 'Skip creating GitHub release (for manual upload)')
+    .action(publishCommand);
+// Upgrade command
+program
+    .command('upgrade [trik]')
+    .alias('up')
+    .description('Upgrade an installed trik (or all triks if none specified)')
+    .option('-f, --force', 'Force reinstall even if up to date')
+    .action(async (trik, options) => {
+    if (trik) {
+        await upgradeCommand(trik, options);
+    }
+    else {
+        await upgradeAllCommand(options);
+    }
+});
+// Sync command (npm-based trik discovery)
+program
+    .command('sync')
+    .description('Discover triks in node_modules and add to config')
+    .option('-n, --dry-run', 'Show what would be synced without modifying config')
+    .option('-j, --json', 'Output as JSON')
+    .action(syncCommand);
+// TODO: Add more commands
+// program.command('init').description('Initialize a new trik project');
+// program.command('outdated').description('Check for outdated triks');
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/info.d.ts

@@ -0,0 +1,11 @@
+/**
+ * trik info command
+ *
+ * Shows detailed information about a trik.
+ */
+interface InfoOptions {
+    json?: boolean;
+}
+export declare function infoCommand(trikInput: string, options: InfoOptions): Promise<void>;
+export {};
+//# sourceMappingURL=info.d.ts.map

package/dist/commands/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../src/commands/info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAgGf"}

package/dist/commands/info.js

@@ -0,0 +1,101 @@
+/**
+ * trik info command
+ *
+ * Shows detailed information about a trik.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import { parseTrikName } from '../types.js';
+import { registry } from '../lib/registry.js';
+import { isTrikInstalled, getInstalledTrik, getTrikPath } from '../lib/storage.js';
+export async function infoCommand(trikInput, options) {
+    const spinner = ora('Fetching trik info...').start();
+    try {
+        const { fullName } = parseTrikName(trikInput);
+        const trik = await registry.getTrik(fullName);
+        spinner.stop();
+        if (!trik) {
+            console.log(chalk.red(`\nTrik ${fullName} not found in registry\n`));
+            process.exit(1);
+        }
+        if (options.json) {
+            console.log(JSON.stringify(trik, null, 2));
+            return;
+        }
+        const installed = getInstalledTrik(fullName);
+        const isInstalled = isTrikInstalled(fullName);
+        // Header
+        console.log();
+        console.log(chalk.bold.cyan(trik.fullName) +
+            (trik.verified ? chalk.blue(' ✓ Verified') : ''));
+        console.log(chalk.dim(trik.description));
+        console.log();
+        // Install status
+        if (isInstalled && installed) {
+            console.log(chalk.green(`✓ Installed`) +
+                chalk.dim(` (v${installed.version})`));
+            console.log(chalk.dim(`  Path: ${getTrikPath(fullName)}`));
+            console.log();
+        }
+        // Stats
+        console.log(chalk.bold('Stats'));
+        console.log(`  Latest version: ${chalk.cyan(trik.latestVersion)}`);
+        console.log(`  Downloads: ${formatNumber(trik.downloads)}`);
+        console.log(`  Stars: ${trik.stars}`);
+        console.log();
+        // Categories & Keywords
+        console.log(chalk.bold('Categories'));
+        console.log(`  ${trik.categories.join(', ')}`);
+        console.log();
+        if (trik.keywords.length > 0) {
+            console.log(chalk.bold('Keywords'));
+            console.log(`  ${trik.keywords.join(', ')}`);
+            console.log();
+        }
+        // Links
+        console.log(chalk.bold('Links'));
+        console.log(`  GitHub: https://github.com/${trik.githubRepo}`);
+        if (trik.discussionsUrl) {
+            console.log(`  Discussions: ${trik.discussionsUrl}`);
+        }
+        console.log();
+        // Versions
+        console.log(chalk.bold('Versions'));
+        const versionsToShow = trik.versions.slice(0, 5);
+        for (const version of versionsToShow) {
+            const date = new Date(version.publishedAt).toLocaleDateString();
+            const current = version.version === trik.latestVersion ? chalk.green(' (latest)') : '';
+            console.log(`  ${chalk.cyan(version.version)}${current} - ${chalk.dim(date)} - ${formatNumber(version.downloads)} downloads`);
+        }
+        if (trik.versions.length > 5) {
+            console.log(chalk.dim(`  ... and ${trik.versions.length - 5} more versions`));
+        }
+        console.log();
+        // Install command
+        if (!isInstalled) {
+            console.log(chalk.bold('Install'));
+            console.log(`  ${chalk.cyan(`trik install ${trik.fullName}`)}`);
+            console.log();
+        }
+    }
+    catch (error) {
+        spinner.fail('Failed to fetch trik info');
+        if (error instanceof Error) {
+            console.error(chalk.red(error.message));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Format a number with K/M suffixes
+ */
+function formatNumber(num) {
+    if (num >= 1_000_000) {
+        return `${(num / 1_000_000).toFixed(1)}M`;
+    }
+    if (num >= 1_000) {
+        return `${(num / 1_000).toFixed(1)}K`;
+    }
+    return num.toString();
+}
+//# sourceMappingURL=info.js.map

package/dist/commands/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../src/commands/info.ts"],"names":[],"mappings":"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"}

package/dist/commands/install.d.ts

@@ -0,0 +1,17 @@
+/**
+ * trik install command
+ *
+ * Installs a trik as an npm dependency and registers it in .trikhub/config.json.
+ *
+ * Workflow:
+ * 1. Try npm registry first
+ * 2. If not found, fall back to TrikHub registry (GitHub releases)
+ * 3. Download and install
+ * 4. Update .trikhub/config.json with the trik
+ */
+interface InstallOptions {
+    version?: string;
+}
+export declare function installCommand(trikInput: string, options: InstallOptions): Promise<void>;
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAyUD,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA0Ff"}