@herjarsa/omo-meta-governor 0.27.0 → 0.28.0

package/dist/cli-anything-sync.d.ts

@@ -0,0 +1,37 @@
+import { type CliAnythingCode, type Runner } from "./cli-anything";
+export interface CliAnythingSyncConfig {
+    /** Enable auto-install + auto-upgrade on plugin load. Default true. */
+    enabled: boolean;
+    /** Auto-install when missing. Default true. */
+    autoInstall: boolean;
+    /** Auto-upgrade when a newer version is available. Default true. */
+    autoUpgrade: boolean;
+    /** Filesystem path for the upgrade-cache file (latest-known version per channel). */
+    cachePath: string;
+    /** Minimum ms between registry queries. Default 24h. */
+    upgradeCheckTtlMs: number;
+    /** Project dir. Default process.cwd(). */
+    projectDir?: string;
+    /** Test-only DI seam — replaces execSync so version probes never spawn real
+     *  pip/npx in hermetic tests. */
+    runner?: Runner;
+    /** Where to install the meta-skill. Default 'global'. */
+    installScope?: "global" | "project";
+    /** Override cli-hub binary path. */
+    cliHubBin?: string;
+    /** Override skills binary path. */
+    skillsBin?: string;
+    /** Install timeout ms. Default 60_000. */
+    installTimeoutMs?: number;
+}
+export interface CliAnythingSyncResult {
+    attempted: boolean;
+    codes: CliAnythingCode[];
+    availability: {
+        cliHub: boolean;
+        cliHubVersion: string | null;
+        metaSkill: boolean;
+    };
+    alreadyInitialized: boolean;
+}
+export declare function runCliAnythingSync(config?: Partial<CliAnythingSyncConfig>): Promise<CliAnythingSyncResult>;

package/dist/cli-anything.d.ts

@@ -0,0 +1,103 @@
+export interface CliAnythingConfig {
+    /** Path to `cli-hub` binary. Default: lookup in PATH. */
+    cliHubBin?: string;
+    /** Path to `pip` binary. Default: auto-probe pip → pip3 → python -m pip → uv. */
+    pipBin?: string;
+    /** Path to `npx skills` invocation. Default: `npx skills`. */
+    skillsBin?: string;
+    /** Default timeoutMs for each subprocess. Default: 60_000. */
+    installTimeoutMs?: number;
+    /** Default timeoutMs for version probes. Default: 10_000. */
+    probeTimeoutMs?: number;
+}
+export interface CliAnythingResult<T = unknown> {
+    /** True if the operation succeeded. */
+    ok: boolean;
+    /** Parsed payload (when JSON output was requested and the call succeeded). */
+    data: T | null;
+    /** Raw stdout (when JSON was not requested). */
+    rawOutput: string | null;
+    /** Truncated stderr (always populated, even on success, for diagnostics). */
+    stderr: string;
+    /** Wall-clock duration in ms. */
+    durationMs: number;
+    /** Diagnostic code (matches CliAnythingCode union). */
+    code: CliAnythingCode;
+}
+export type CliAnythingCode = "cli-anything-install-succeeded" | "cli-anything-install-failed" | "cli-anything-already-installed" | "cli-anything-upgrade-succeeded" | "cli-anything-upgrade-failed" | "cli-anything-upgrade-skipped" | "cli-hub-version-probed" | "cli-hub-version-probe-failed" | "cli-hub-list-succeeded" | "cli-hub-list-failed" | "cli-hub-search-succeeded" | "cli-hub-search-failed" | "cli-hub-info-succeeded" | "cli-hub-info-failed" | "cli-hub-install-succeeded" | "cli-hub-install-failed" | "skill-install-succeeded" | "skill-install-failed" | "skill-upgrade-succeeded" | "skill-upgrade-failed" | "skill-already-current";
+export interface CliHubListEntry {
+    name: string;
+    display_name: string;
+    version: string;
+    description: string;
+    requires: string | null;
+    homepage: string | null;
+    install_cmd: string | null;
+    entry_point: string | null;
+    category: string;
+    _source: "harness" | "public" | "npm";
+}
+export type Runner = (cmd: string, opts?: {
+    timeoutMs?: number;
+}) => string;
+/**
+ * Get the installed cli-anything-hub version.
+ * Returns null when not installed.
+ */
+export declare function getInstalledCliHubVersion(runner?: Runner): string | null;
+/**
+ * Fetch the latest cli-anything-hub version from PyPI.
+ * Returns null on any failure.
+ */
+export declare function fetchCliHubLatestVersion(runner?: Runner): string | null;
+/**
+ * Compare two semver strings. Returns -1 / 0 / 1.
+ * Treats "latest" / empty as newer than anything (defensive).
+ */
+export declare function compareSemver(a: string, b: string): -1 | 0 | 1;
+/**
+ * Install cli-anything-hub. Tries the safer methods first to avoid
+ * PEP 668 conflicts:
+ *  1. uv tool install (clean isolated env)
+ *  2. uv pip install --system (PEP 668-safe with --break-system-packages)
+ *  3. pip install --user (older fallback, no system pollution)
+ *  4. pip install (last resort; uses --break-system-packages on PEP 668 systems)
+ */
+export declare function installCliHub(runner?: Runner, timeoutMs?: number): CliAnythingResult;
+/**
+ * Upgrade cli-anything-hub. Same tier order as installCliHub.
+ */
+export declare function upgradeCliHub(runner?: Runner, timeoutMs?: number): CliAnythingResult;
+export interface ListOptions {
+    category?: string;
+    source?: "harness" | "public" | "npm" | "all";
+}
+/**
+ * List all available CLIs from the CLI-Anything hub registry.
+ */
+export declare function listClis(options?: ListOptions, runner?: Runner, timeoutMs?: number, cliHubBin?: string): CliAnythingResult<CliHubListEntry[]>;
+/**
+ * Search CLIs by query string.
+ */
+export declare function searchClis(query: string, runner?: Runner, timeoutMs?: number, cliHubBin?: string): CliAnythingResult<CliHubListEntry[]>;
+/**
+ * Show details for a specific CLI by name.
+ */
+export declare function infoCli(name: string, runner?: Runner, timeoutMs?: number, cliHubBin?: string): CliAnythingResult<string>;
+/**
+ * Install a specific CLI by name (e.g. "gimp").
+ */
+export declare function installCli(name: string, runner?: Runner, timeoutMs?: number, cliHubBin?: string): CliAnythingResult;
+/**
+ * Install the cli-hub-meta-skill via `npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill`.
+ * scope: 'global' (default) installs to ~/.claude/skills/, 'project' to ./.claude/skills/.
+ */
+export declare function installCliHubMetaSkill(scope?: "global" | "project", runner?: Runner, timeoutMs?: number, skillsBin?: string): CliAnythingResult;
+/**
+ * Upgrade the cli-hub-meta-skill via `npx skills update`.
+ */
+export declare function upgradeCliHubMetaSkill(scope?: "global" | "project", runner?: Runner, timeoutMs?: number, skillsBin?: string): CliAnythingResult;
+/**
+ * Check whether cli-hub-meta-skill is installed by parsing `npx skills list --global`.
+ */
+export declare function isCliHubMetaSkillInstalled(scope?: "global" | "project", runner?: Runner, timeoutMs?: number, skillsBin?: string): boolean;

package/dist/config.d.ts

@@ -105,6 +105,19 @@ export interface MetaGovernorPluginConfig {
          * Default false (opt-in — multi-project users want explicit control). */
         addToGlobalGraph?: boolean;
     };
+    /** v0.28.0: CLI-Anything hub auto-install + auto-upgrade. Opt-in.
+     *  When enabled, the plugin ensures `cli-anything-hub` (pip) and
+     *  `cli-hub-meta-skill` (npx skills) are installed and current. */
+    cliAnything?: {
+        enabled?: boolean;
+        autoInstall?: boolean;
+        autoUpgrade?: boolean;
+        cachePath?: string;
+        upgradeCheckTtlMs?: number;
+        cliHubBin?: string;
+        skillsBin?: string;
+        installScope?: "global" | "project";
+    };
     /** Skill priming config (v0.20.0): proactive skill-selection nudge. */
     skillPriming?: {
         enabled?: boolean;

package/dist/custom-tools.d.ts

@@ -441,4 +441,58 @@ export declare function buildOmoHookStatusTool(deps: OmoHookStatusDeps): {
     args: {};
     execute(args: Record<string, never>, context: ToolContext): Promise<ToolResult>;
 };
+export interface OmoCliAnythingDeps {
+    cwd: string;
+    /** Optional runner DI seam for tests. When undefined, uses real execSync. */
+    runner?: (cmd: string, opts?: {
+        timeoutMs?: number;
+    }) => string;
+}
+/** Install a CLI from the CLI-Anything hub (e.g. `gimp`, `blender`, `drawio`). */
+export declare function buildOmoCliAnythingInstallTool(deps: OmoCliAnythingDeps): {
+    description: string;
+    args: {
+        name: import("zod").ZodString;
+    };
+    execute(args: {
+        name: string;
+    }, context: ToolContext): Promise<ToolResult>;
+};
+/** List all CLIs available in the CLI-Anything hub. */
+export declare function buildOmoCliAnythingListTool(deps: OmoCliAnythingDeps): {
+    description: string;
+    args: {
+        category: import("zod").ZodOptional<import("zod").ZodString>;
+        source: import("zod").ZodOptional<import("zod").ZodEnum<{
+            all: "all";
+            harness: "harness";
+            npm: "npm";
+            public: "public";
+        }>>;
+    };
+    execute(args: {
+        category?: string | undefined;
+        source?: "all" | "harness" | "npm" | "public" | undefined;
+    }, context: ToolContext): Promise<ToolResult>;
+};
+/** Search the CLI-Anything hub for CLIs matching a query. */
+export declare function buildOmoCliAnythingSearchTool(deps: OmoCliAnythingDeps): {
+    description: string;
+    args: {
+        query: import("zod").ZodString;
+    };
+    execute(args: {
+        query: string;
+    }, context: ToolContext): Promise<ToolResult>;
+};
+/** Show details (display name, version, requires, install cmd, entry point) for a CLI. */
+export declare function buildOmoCliAnythingInfoTool(deps: OmoCliAnythingDeps): {
+    description: string;
+    args: {
+        name: import("zod").ZodString;
+    };
+    execute(args: {
+        name: string;
+    }, context: ToolContext): Promise<ToolResult>;
+};
 export {};

package/dist/health.d.ts

@@ -39,6 +39,47 @@ export interface PluginHealth {
         firstSeenISO: string;
         lastSeenISO: string;
     };
+    graphSync?: {
+        lastUpgradeAtISO: string | null;
+        lastUpgradeResult: "success" | "failed" | "skipped" | "unknown";
+        lastUpgradeTarget: "codegraph" | "graphify" | null;
+        lastUpgradeMs: number | null;
+    };
+    graphToolsUsed: {
+        omo_search: number;
+        omo_recall: number;
+        omo_health: number;
+        omo_find: number;
+        omo_impact: number;
+        omo_remember: number;
+        omo_recall_mcp: number;
+        omo_path: number;
+        omo_explain: number;
+        omo_files: number;
+        omo_callers: number;
+        omo_node: number;
+        omo_context: number;
+        omo_affected_cg: number;
+        omo_status: number;
+        omo_unlock: number;
+        omo_mark_dirty: number;
+        omo_sync_if_dirty: number;
+        omo_index: number;
+        omo_visualize: number;
+        omo_serve: number;
+        omo_uninit: number;
+        omo_diagnose: number;
+        omo_merge_graphs: number;
+        omo_save_result: number;
+        omo_extract: number;
+        omo_cluster_only: number;
+        omo_label: number;
+        omo_tree: number;
+        omo_clone: number;
+        omo_add: number;
+        omo_check_update: number;
+        omo_hook_status: number;
+    };
 }
 /**
  * Atomically write the health state to the given path. Writes to a