@liangjie559567/ultrapower 5.2.1 → 5.2.3

package/dist/lib/plugin-registry.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Plugin registry synchronization utilities for ultrapower.
+ *
+ * IMPORTANT: This module must NOT import from auto-update.ts or installer/index.ts
+ * to prevent circular dependencies. Callers must pass any context (e.g. isProjectScoped)
+ * as parameters. See installer/index.ts lines 97-98 for context.
+ */
+export interface SyncOptions {
+    newVersion: string;
+    /** If true, skip sync (caller determined plugin is project-scoped). */
+    skipIfProjectScoped?: boolean;
+}
+export interface SyncResult {
+    success: boolean;
+    skipped?: boolean;
+    previousVersion?: string;
+    newVersion: string;
+    registryPath: string;
+    errors?: string[];
+}
+export interface ConsistencyReport {
+    consistent: boolean;
+    packageJsonVersion: string;
+    versionMetadataVersion: string | null;
+    registryVersion: string | null;
+    discrepancies: string[];
+    fixCommand?: string;
+    isUpdating?: boolean;
+}
+/**
+ * Sync the version field in installed_plugins.json for ultrapower.
+ * Only updates `version` and `lastUpdated`; does not modify `installPath`.
+ */
+export declare function syncPluginRegistry(options: SyncOptions): SyncResult;
+/**
+ * Check version consistency across three sources:
+ * 1. package.json (runtime)
+ * 2. installed_plugins.json (registry)
+ * 3. version.json in plugin cache
+ */
+export declare function checkVersionConsistency(): ConsistencyReport;
+//# sourceMappingURL=plugin-registry.d.ts.map

package/dist/lib/plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../../src/lib/plugin-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA8ED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAqCnE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CA8C3D"}

package/dist/lib/plugin-registry.js

@@ -0,0 +1,169 @@
+/**
+ * Plugin registry synchronization utilities for ultrapower.
+ *
+ * IMPORTANT: This module must NOT import from auto-update.ts or installer/index.ts
+ * to prevent circular dependencies. Callers must pass any context (e.g. isProjectScoped)
+ * as parameters. See installer/index.ts lines 97-98 for context.
+ */
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+import { atomicWriteJsonSync } from './atomic-write.js';
+// ---- Constants ----
+const PLUGIN_KEY = 'ultrapower@ultrapower';
+const REGISTRY_PATH = join(homedir(), '.claude', 'plugins', 'installed_plugins.json');
+// ---- Internal helpers ----
+/**
+ * Read the installed_plugins.json entry for ultrapower.
+ * Returns null if file doesn't exist or entry not found.
+ */
+function getInstalledPluginEntry() {
+    try {
+        if (!existsSync(REGISTRY_PATH)) {
+            return null;
+        }
+        const raw = readFileSync(REGISTRY_PATH, 'utf-8');
+        const registry = JSON.parse(raw);
+        const entries = registry?.plugins?.[PLUGIN_KEY];
+        if (!Array.isArray(entries) || entries.length === 0) {
+            return null;
+        }
+        return entries[0];
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the runtime package.json version.
+ * Walks up from __dirname to find package.json.
+ */
+function getPackageJsonVersion() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dir = dirname(__filename);
+        for (let i = 0; i < 5; i++) {
+            const candidate = join(__dir, ...Array(i + 1).fill('..'), 'package.json');
+            try {
+                const pkg = JSON.parse(readFileSync(candidate, 'utf-8'));
+                if (pkg.name && pkg.version) {
+                    return pkg.version;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return 'unknown';
+}
+/**
+ * Read version from version metadata file in plugin cache.
+ * Path: ~/.claude/plugins/cache/ultrapower/ultrapower/{version}/version.json
+ */
+function getVersionMetadataVersion(registryVersion) {
+    if (!registryVersion)
+        return null;
+    try {
+        const versionJsonPath = join(homedir(), '.claude', 'plugins', 'cache', 'ultrapower', 'ultrapower', registryVersion, 'version.json');
+        if (!existsSync(versionJsonPath))
+            return null;
+        const raw = readFileSync(versionJsonPath, 'utf-8');
+        const data = JSON.parse(raw);
+        return data?.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+// ---- Public API ----
+/**
+ * Sync the version field in installed_plugins.json for ultrapower.
+ * Only updates `version` and `lastUpdated`; does not modify `installPath`.
+ */
+export function syncPluginRegistry(options) {
+    const { newVersion, skipIfProjectScoped } = options;
+    if (skipIfProjectScoped) {
+        return { success: true, skipped: true, newVersion, registryPath: REGISTRY_PATH };
+    }
+    const entry = getInstalledPluginEntry();
+    if (entry === null) {
+        // File doesn't exist or key not found — check which case
+        if (!existsSync(REGISTRY_PATH)) {
+            return { success: true, skipped: true, newVersion, registryPath: REGISTRY_PATH };
+        }
+        // File exists but key not found
+        return {
+            success: false,
+            newVersion,
+            registryPath: REGISTRY_PATH,
+            errors: [`Entry '${PLUGIN_KEY}' not found in registry`],
+        };
+    }
+    const previousVersion = entry.version;
+    try {
+        const raw = readFileSync(REGISTRY_PATH, 'utf-8');
+        const registry = JSON.parse(raw);
+        const entries = registry.plugins[PLUGIN_KEY];
+        entries[0].version = newVersion;
+        entries[0].lastUpdated = new Date().toISOString();
+        atomicWriteJsonSync(REGISTRY_PATH, registry);
+        return { success: true, previousVersion, newVersion, registryPath: REGISTRY_PATH };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { success: false, newVersion, registryPath: REGISTRY_PATH, errors: [msg] };
+    }
+}
+/**
+ * Check version consistency across three sources:
+ * 1. package.json (runtime)
+ * 2. installed_plugins.json (registry)
+ * 3. version.json in plugin cache
+ */
+export function checkVersionConsistency() {
+    const packageJsonVersion = getPackageJsonVersion();
+    const entry = getInstalledPluginEntry();
+    const registryVersion = entry?.version ?? null;
+    const versionMetadataVersion = getVersionMetadataVersion(registryVersion);
+    const sources = [
+        ['package.json', packageJsonVersion],
+        ['installed_plugins.json', registryVersion],
+        ['version metadata', versionMetadataVersion],
+    ];
+    const knownVersions = sources
+        .map(([, v]) => v)
+        .filter((v) => v !== null && v !== 'unknown');
+    const allSame = knownVersions.length > 0 && knownVersions.every(v => v === knownVersions[0]);
+    const consistent = allSame && knownVersions.length === sources.length;
+    const discrepancies = [];
+    if (!consistent) {
+        for (const [label, v] of sources) {
+            if (v === null) {
+                discrepancies.push(`${label}: not found`);
+            }
+            else if (v !== packageJsonVersion) {
+                discrepancies.push(`${label}: ${v} (expected ${packageJsonVersion})`);
+            }
+        }
+    }
+    // isUpdating: registry version differs from package.json (update in progress)
+    const isUpdating = registryVersion !== null && registryVersion !== packageJsonVersion;
+    const fixCommand = consistent
+        ? undefined
+        : '/plugin install ultrapower  # or: /update (if installed via npm)';
+    return {
+        consistent,
+        packageJsonVersion,
+        versionMetadataVersion,
+        registryVersion,
+        discrepancies,
+        fixCommand: consistent ? undefined : fixCommand,
+        isUpdating,
+    };
+}
+//# sourceMappingURL=plugin-registry.js.map

package/dist/lib/plugin-registry.js.map

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

package/docs/CLAUDE.md

@@ -1,5 +1,5 @@
 <!-- OMC:START -->
-<!-- OMC:VERSION:5.2.1 -->
+<!-- OMC:VERSION:5.2.2 -->
 # ultrapower - Multi-Agent Orchestration 智能多 Agent 编排
 
 你正在使用 ultrapower（OMC），这是 Claude Code 的多 agent 编排层。