@trikhub/cli 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,187 @@
+/**
+ * TrikHub Types
+ *
+ * Core type definitions for the TrikHub ecosystem.
+ */
+/**
+ * trikhub.json - Registry metadata for a trik
+ * This file lives alongside manifest.json in a trik repository
+ */
+export interface TrikHubMetadata {
+    /** Human-readable display name */
+    displayName: string;
+    /** Short description (max 160 chars, for search results) */
+    shortDescription: string;
+    /** Categories for browsing/filtering */
+    categories: TrikCategory[];
+    /** Keywords for search */
+    keywords: string[];
+    /** Author information */
+    author: {
+        name: string;
+        github: string;
+        email?: string;
+    };
+    /** GitHub repository URL */
+    repository: string;
+    /** Optional homepage/docs URL */
+    homepage?: string;
+    /** Optional funding URL (GitHub Sponsors, etc.) */
+    funding?: string;
+    /** Optional icon URL (should be square, min 128x128) */
+    icon?: string;
+}
+/**
+ * Predefined categories for triks
+ */
+export type TrikCategory = 'search' | 'content' | 'productivity' | 'communication' | 'data' | 'developer' | 'finance' | 'entertainment' | 'education' | 'utilities' | 'other';
+/**
+ * Trik information returned from the registry
+ */
+export interface TrikInfo {
+    /** Scoped name (e.g., "@acme/article-search") */
+    fullName: string;
+    /** Scope (e.g., "@acme") */
+    scope: string;
+    /** Name without scope (e.g., "article-search") */
+    name: string;
+    /** GitHub repository (e.g., "acme/trikhub-article-search") */
+    githubRepo: string;
+    /** Latest version */
+    latestVersion: string;
+    /** Description from trikhub.json */
+    description: string;
+    /** Categories */
+    categories: TrikCategory[];
+    /** Keywords */
+    keywords: string[];
+    /** Total download count */
+    downloads: number;
+    /** GitHub stars (cached) */
+    stars: number;
+    /** Whether the publisher is verified */
+    verified: boolean;
+    /** GitHub Discussions URL */
+    discussionsUrl?: string;
+    /** Available versions */
+    versions: TrikVersion[];
+    /** Timestamps */
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Version information for a trik
+ */
+export interface TrikVersion {
+    /** Semantic version (e.g., "1.2.3") */
+    version: string;
+    /** GitHub release URL */
+    releaseUrl: string;
+    /** Direct tarball download URL */
+    tarballUrl: string;
+    /** SHA-256 hash of the tarball for integrity verification */
+    sha256: string | null;
+    /** When this version was published */
+    publishedAt: string;
+    /** Download count for this version */
+    downloads: number;
+}
+/**
+ * Installed trik entry in the lockfile
+ */
+export interface InstalledTrik {
+    /** Scoped name */
+    fullName: string;
+    /** Installed version */
+    version: string;
+    /** GitHub repo it was installed from */
+    githubRepo: string;
+    /** When it was installed */
+    installedAt: string;
+    /** SHA of the tarball (for integrity) */
+    integrity?: string;
+}
+/**
+ * Lockfile structure (~/.trikhub/triks.lock)
+ */
+export interface TrikLockfile {
+    /** Lockfile format version */
+    lockfileVersion: 1;
+    /** Map of installed triks by full name */
+    triks: Record<string, InstalledTrik>;
+}
+/**
+ * CLI configuration (~/.trikhub/config.json)
+ */
+export interface TrikConfig {
+    /** Registry URL (default: https://api.trikhub.com) */
+    registry: string;
+    /** Directory where triks are installed */
+    triksDirectory: string;
+    /** Whether to send anonymous analytics */
+    analytics: boolean;
+    /** Authentication token for registry API */
+    authToken?: string;
+    /** When the auth token expires */
+    authExpiresAt?: string;
+    /** Username of the authenticated publisher */
+    publisherUsername?: string;
+}
+/**
+ * Publisher information from the registry
+ */
+export interface Publisher {
+    id: number;
+    username: string;
+    displayName: string;
+    avatarUrl: string;
+    verified: boolean;
+    createdAt: string;
+}
+/**
+ * Device authorization response from registry
+ */
+export interface DeviceAuthResponse {
+    deviceCode: string;
+    userCode: string;
+    verificationUrl: string;
+    expiresIn: number;
+    interval: number;
+}
+/**
+ * Auth result after successful device flow
+ */
+export interface AuthResult {
+    accessToken: string;
+    expiresAt: string;
+    publisher: Publisher;
+}
+/**
+ * Search results from the registry
+ */
+export interface SearchResult {
+    /** Total number of results */
+    total: number;
+    /** Current page */
+    page: number;
+    /** Results per page */
+    perPage: number;
+    /** The trik results */
+    results: TrikInfo[];
+}
+/**
+ * Parse a scoped trik name into its parts
+ * @example parseTrikName("@acme/article-search") => { scope: "@acme", name: "article-search", fullName: "@acme/article-search" }
+ * @example parseTrikName("@acme/article-search@1.2.3") => { scope: "@acme", name: "article-search", fullName: "@acme/article-search", version: "1.2.3" }
+ */
+export declare function parseTrikName(input: string): {
+    scope: string;
+    name: string;
+    fullName: string;
+    version?: string;
+};
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: TrikConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,36 @@
+/**
+ * TrikHub Types
+ *
+ * Core type definitions for the TrikHub ecosystem.
+ */
+/**
+ * Parse a scoped trik name into its parts
+ * @example parseTrikName("@acme/article-search") => { scope: "@acme", name: "article-search", fullName: "@acme/article-search" }
+ * @example parseTrikName("@acme/article-search@1.2.3") => { scope: "@acme", name: "article-search", fullName: "@acme/article-search", version: "1.2.3" }
+ */
+export function parseTrikName(input) {
+    // Match @scope/name or @scope/name@version
+    const match = input.match(/^(@[^/]+)\/([^@]+)(?:@(.+))?$/);
+    if (!match) {
+        throw new Error(`Invalid trik name: "${input}". Expected format: @scope/name or @scope/name@version`);
+    }
+    const [, rawScope, rawName, version] = match;
+    // Normalize to lowercase for consistency
+    const scope = rawScope.toLowerCase();
+    const name = rawName.toLowerCase();
+    return {
+        scope,
+        name,
+        fullName: `${scope}/${name}`,
+        version,
+    };
+}
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    registry: 'https://api.trikhub.com',
+    triksDirectory: '~/.trikhub/triks',
+    analytics: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqOH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IAMzC,2CAA2C;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAE3D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,uBAAuB,KAAK,wDAAwD,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;IAE7C,yCAAyC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEnC,OAAO;QACL,KAAK;QACL,IAAI;QACJ,QAAQ,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE;QAC5B,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,QAAQ,EAAE,yBAAyB;IACnC,cAAc,EAAE,kBAAkB;IAClC,SAAS,EAAE,IAAI;CAChB,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@trikhub/cli",
+  "version": "0.2.0",
+  "description": "CLI for TrikHub - Teaching AI new triks",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "trik": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@inquirer/prompts": "^7.2.1",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "conf": "^13.0.1",
+    "ora": "^8.0.1",
+    "semver": "^7.6.3",
+    "tar": "^7.4.0",
+    "@trikhub/manifest": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "@types/semver": "^7.5.8",
+    "@types/tar": "^6.1.13"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Muffles/trikhub.git",
+    "directory": "packages/trik-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/Muffles/trikhub/issues"
+  },
+  "homepage": "https://github.com/Muffles/trikhub/tree/main/packages/trik-cli#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "trikhub",
+    "trik",
+    "ai",
+    "skills",
+    "cli"
+  ],
+  "author": "Muffles",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}