@jackwener/opencli 1.4.0 → 1.5.0

package/dist/plugin-manifest.test.js

@@ -0,0 +1,179 @@
+/**
+ * Tests for plugin manifest: reading, validating, and compatibility checks.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { _readPluginManifest as readPluginManifest, _isMonorepo as isMonorepo, _getEnabledPlugins as getEnabledPlugins, _parseVersion as parseVersion, _satisfiesRange as satisfiesRange, MANIFEST_FILENAME, } from './plugin-manifest.js';
+// ── readPluginManifest ──────────────────────────────────────────────────────
+describe('readPluginManifest', () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencli-manifest-test-'));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('returns null when no manifest file exists', () => {
+        expect(readPluginManifest(tmpDir)).toBeNull();
+    });
+    it('returns null for malformed JSON', () => {
+        fs.writeFileSync(path.join(tmpDir, MANIFEST_FILENAME), 'not json {{{');
+        expect(readPluginManifest(tmpDir)).toBeNull();
+    });
+    it('returns null for non-object JSON (array)', () => {
+        fs.writeFileSync(path.join(tmpDir, MANIFEST_FILENAME), '["a","b"]');
+        expect(readPluginManifest(tmpDir)).toBeNull();
+    });
+    it('returns null for non-object JSON (string)', () => {
+        fs.writeFileSync(path.join(tmpDir, MANIFEST_FILENAME), '"hello"');
+        expect(readPluginManifest(tmpDir)).toBeNull();
+    });
+    it('reads a single-plugin manifest', () => {
+        const manifest = {
+            name: 'polymarket',
+            version: '1.2.0',
+            opencli: '>=1.0.0',
+            description: 'Prediction market analysis',
+        };
+        fs.writeFileSync(path.join(tmpDir, MANIFEST_FILENAME), JSON.stringify(manifest));
+        const result = readPluginManifest(tmpDir);
+        expect(result).toEqual(manifest);
+    });
+    it('reads a monorepo manifest', () => {
+        const manifest = {
+            version: '1.0.0',
+            opencli: '>=0.9.0',
+            description: 'My plugin collection',
+            plugins: {
+                polymarket: {
+                    path: 'packages/polymarket',
+                    description: 'Prediction market',
+                    version: '1.2.0',
+                },
+                defi: {
+                    path: 'packages/defi',
+                    description: 'DeFi data',
+                    version: '0.8.0',
+                    disabled: true,
+                },
+            },
+        };
+        fs.writeFileSync(path.join(tmpDir, MANIFEST_FILENAME), JSON.stringify(manifest));
+        const result = readPluginManifest(tmpDir);
+        expect(result).toEqual(manifest);
+        expect(result.plugins.polymarket.path).toBe('packages/polymarket');
+        expect(result.plugins.defi.disabled).toBe(true);
+    });
+});
+// ── isMonorepo ──────────────────────────────────────────────────────────────
+describe('isMonorepo', () => {
+    it('returns false for single-plugin manifest', () => {
+        expect(isMonorepo({ name: 'test', version: '1.0.0' })).toBe(false);
+    });
+    it('returns false for empty plugins object', () => {
+        expect(isMonorepo({ plugins: {} })).toBe(false);
+    });
+    it('returns true for manifest with plugins', () => {
+        expect(isMonorepo({
+            plugins: {
+                foo: { path: 'packages/foo' },
+            },
+        })).toBe(true);
+    });
+});
+// ── getEnabledPlugins ───────────────────────────────────────────────────────
+describe('getEnabledPlugins', () => {
+    it('returns empty array for no plugins', () => {
+        expect(getEnabledPlugins({ name: 'test' })).toEqual([]);
+    });
+    it('filters out disabled plugins', () => {
+        const manifest = {
+            plugins: {
+                foo: { path: 'packages/foo' },
+                bar: { path: 'packages/bar', disabled: true },
+                baz: { path: 'packages/baz' },
+            },
+        };
+        const result = getEnabledPlugins(manifest);
+        expect(result).toHaveLength(2);
+        expect(result.map((r) => r.name)).toEqual(['baz', 'foo']); // sorted
+    });
+    it('returns all when none disabled', () => {
+        const manifest = {
+            plugins: {
+                charlie: { path: 'packages/charlie' },
+                alpha: { path: 'packages/alpha' },
+            },
+        };
+        const result = getEnabledPlugins(manifest);
+        expect(result).toHaveLength(2);
+        expect(result[0].name).toBe('alpha');
+        expect(result[1].name).toBe('charlie');
+    });
+});
+// ── parseVersion ────────────────────────────────────────────────────────────
+describe('parseVersion', () => {
+    it('parses standard versions', () => {
+        expect(parseVersion('1.2.3')).toEqual([1, 2, 3]);
+        expect(parseVersion('0.0.0')).toEqual([0, 0, 0]);
+        expect(parseVersion('10.20.30')).toEqual([10, 20, 30]);
+    });
+    it('parses versions with prerelease suffix', () => {
+        expect(parseVersion('1.2.3-beta.1')).toEqual([1, 2, 3]);
+    });
+    it('returns null for invalid versions', () => {
+        expect(parseVersion('abc')).toBeNull();
+        expect(parseVersion('')).toBeNull();
+        expect(parseVersion('1.2')).toBeNull();
+    });
+});
+// ── satisfiesRange ──────────────────────────────────────────────────────────
+describe('satisfiesRange', () => {
+    it('handles >= constraint', () => {
+        expect(satisfiesRange('1.4.1', '>=1.0.0')).toBe(true);
+        expect(satisfiesRange('1.0.0', '>=1.0.0')).toBe(true);
+        expect(satisfiesRange('0.9.9', '>=1.0.0')).toBe(false);
+    });
+    it('handles <= constraint', () => {
+        expect(satisfiesRange('1.0.0', '<=1.0.0')).toBe(true);
+        expect(satisfiesRange('0.9.0', '<=1.0.0')).toBe(true);
+        expect(satisfiesRange('1.0.1', '<=1.0.0')).toBe(false);
+    });
+    it('handles > constraint', () => {
+        expect(satisfiesRange('1.0.1', '>1.0.0')).toBe(true);
+        expect(satisfiesRange('1.0.0', '>1.0.0')).toBe(false);
+    });
+    it('handles < constraint', () => {
+        expect(satisfiesRange('0.9.9', '<1.0.0')).toBe(true);
+        expect(satisfiesRange('1.0.0', '<1.0.0')).toBe(false);
+    });
+    it('handles ^ (caret) constraint', () => {
+        expect(satisfiesRange('1.2.0', '^1.2.0')).toBe(true);
+        expect(satisfiesRange('1.9.9', '^1.2.0')).toBe(true);
+        expect(satisfiesRange('2.0.0', '^1.2.0')).toBe(false);
+        expect(satisfiesRange('1.1.0', '^1.2.0')).toBe(false);
+    });
+    it('handles ~ (tilde) constraint', () => {
+        expect(satisfiesRange('1.2.0', '~1.2.0')).toBe(true);
+        expect(satisfiesRange('1.2.9', '~1.2.0')).toBe(true);
+        expect(satisfiesRange('1.3.0', '~1.2.0')).toBe(false);
+    });
+    it('handles exact match', () => {
+        expect(satisfiesRange('1.2.3', '1.2.3')).toBe(true);
+        expect(satisfiesRange('1.2.4', '1.2.3')).toBe(false);
+    });
+    it('handles compound range (AND)', () => {
+        expect(satisfiesRange('1.5.0', '>=1.0.0 <2.0.0')).toBe(true);
+        expect(satisfiesRange('2.0.0', '>=1.0.0 <2.0.0')).toBe(false);
+        expect(satisfiesRange('0.9.0', '>=1.0.0 <2.0.0')).toBe(false);
+    });
+    it('returns true for empty range', () => {
+        expect(satisfiesRange('1.0.0', '')).toBe(true);
+        expect(satisfiesRange('1.0.0', '  ')).toBe(true);
+    });
+    it('returns true for unparseable version', () => {
+        expect(satisfiesRange('dev', '>=1.0.0')).toBe(true);
+    });
+});

package/dist/plugin.d.ts

@@ -2,16 +2,27 @@
  * Plugin management: install, uninstall, and list plugins.
  *
  * Plugins live in ~/.opencli/plugins/<name>/.
- * Install source format: "github:user/repo"
+ * Monorepo clones live in ~/.opencli/monorepos/<repo-name>/.
+ * Install source format: "github:user/repo" or "github:user/repo/subplugin"
  */
 /** Path to the lock file that tracks installed plugin versions. */
 export declare function getLockFilePath(): string;
+/** Monorepo clones directory: ~/.opencli/monorepos/ */
+export declare function getMonoreposDir(): string;
 export declare const LOCK_FILE: string;
+export declare const MONOREPOS_DIR: string;
 export interface LockEntry {
     source: string;
     commitHash: string;
     installedAt: string;
     updatedAt?: string;
+    /** Present when this plugin comes from a monorepo. */
+    monorepo?: {
+        /** Monorepo directory name under ~/.opencli/monorepos/ */
+        name: string;
+        /** Relative path of this sub-plugin within the monorepo. */
+        subPath: string;
+    };
 }
 export interface PluginInfo {
     name: string;
@@ -20,6 +31,10 @@ export interface PluginInfo {
     source?: string;
     version?: string;
     installedAt?: string;
+    /** If from a monorepo, the monorepo name. */
+    monorepoName?: string;
+    /** Description from opencli-plugin.json. */
+    description?: string;
 }
 export interface ValidationResult {
     valid: boolean;
@@ -35,17 +50,33 @@ export declare function getCommitHash(dir: string): string | undefined;
  * package.json if it contains .ts files.
  */
 export declare function validatePluginStructure(pluginDir: string): ValidationResult;
+declare function installDependencies(dir: string): void;
+/**
+ * Monorepo lifecycle: install shared deps once at repo root, then finalize each sub-plugin.
+ */
+declare function postInstallMonorepoLifecycle(repoDir: string, pluginDirs: string[]): void;
 /**
  * Install a plugin from a source.
- * Currently supports "github:user/repo" format (git clone wrapper).
+ * Supports:
+ *   "github:user/repo"            — single plugin or full monorepo
+ *   "github:user/repo/subplugin"  — specific sub-plugin from a monorepo
+ *   "https://github.com/user/repo"
+ *
+ * Returns the installed plugin name(s).
  */
-export declare function installPlugin(source: string): string;
+export declare function installPlugin(source: string): string | string[];
 /**
  * Uninstall a plugin by name.
+ * For monorepo sub-plugins: removes symlink and cleans up the monorepo
+ * directory when no more sub-plugins reference it.
  */
 export declare function uninstallPlugin(name: string): void;
+/** Synchronous check if a path is a symlink. */
+declare function isSymlinkSync(p: string): boolean;
 /**
  * Update a plugin by name (git pull + re-install lifecycle).
+ * For monorepo sub-plugins: pulls the monorepo root and re-runs lifecycle
+ * for all sub-plugins from the same monorepo.
  */
 export declare function updatePlugin(name: string): void;
 export interface UpdateResult {
@@ -60,15 +91,17 @@ export interface UpdateResult {
 export declare function updateAllPlugins(): UpdateResult[];
 /**
  * List all installed plugins.
+ * Reads opencli-plugin.json for description/version when available.
  */
 export declare function listPlugins(): PluginInfo[];
-/** Parse a plugin source string into clone URL and name */
+/** Parse a plugin source string into clone URL, repo name, and optional sub-plugin. */
 declare function parseSource(source: string): {
     cloneUrl: string;
     name: string;
+    subPlugin?: string;
 } | null;
 /**
  * Resolve the path to the esbuild CLI executable with fallback strategies.
  */
 export declare function resolveEsbuildBin(): string | null;
-export { resolveEsbuildBin as _resolveEsbuildBin, getCommitHash as _getCommitHash, parseSource as _parseSource, readLockFile as _readLockFile, updateAllPlugins as _updateAllPlugins, validatePluginStructure as _validatePluginStructure, writeLockFile as _writeLockFile, };
+export { resolveEsbuildBin as _resolveEsbuildBin, getCommitHash as _getCommitHash, installDependencies as _installDependencies, parseSource as _parseSource, postInstallMonorepoLifecycle as _postInstallMonorepoLifecycle, readLockFile as _readLockFile, updateAllPlugins as _updateAllPlugins, validatePluginStructure as _validatePluginStructure, writeLockFile as _writeLockFile, isSymlinkSync as _isSymlinkSync, getMonoreposDir as _getMonoreposDir, };