@yhong91/cpac 0.2.5 → 0.2.7

package/README.md

@@ -166,7 +166,7 @@ cpac --help
 
 ```bash
 cpac detect [--json]
-cpac models [--json]
+cpac models [--json] [--diff]
 cpac install [codex|pi|kimi|grok|zed|hermes|codebuddy...] [--all] [--dry-run] [--force] [--v2_off] [--v2_models] [--max_context]
 cpac sync [codex|pi|kimi|grok|zed|hermes|codebuddy...] [--all] [--dry-run] [--v2_off] [--v2_models] [--max_context]
 cpac restore <codex|pi|kimi|grok|zed|hermes|codebuddy...> | --all [--dry-run]
@@ -175,7 +175,7 @@ cpac upgrade [--check]
 cpac -v | --version
 ```
 
-- `models` 从远端 CPA 拉取 rich catalog，默认一行一个 slug；`--json` 输出 `cpa_url` 和模型字段（`slug` / `display_name` / `context_window`）。用来核对 catalog 里有没有某个模型（例如 `*-fast`），不写本地配置。
+- `models` 从远端 CPA 拉取 rich catalog，默认一行一个 slug；`--json` 输出 `cpa_url` 和模型字段（`slug` / `display_name` / `context_window`）。用来核对 catalog 里有没有某个模型（例如 `*-fast`），不写本地配置。`--diff` 拿已保存的 `state_dir/models.json` 和当前 catalog 比 slug：`+` 是新增，`-` 是去掉；没有差别打印 `unchanged`。还没有保存列表时报错，先跑 `cpac sync`。
 - `detect` 列出每个目标是否被检测到、是否已接入 CPAC；`--json` 输出机器可读结果。
 - `install` 默认作用于检测到的目标；后面直接写 agent 名（`cpac install codex pi`），`--all` 全部。`codex` 写入 catalog 并拉起 loopback 代理；`pi`/`kimi`/`grok`/`zed`/`hermes`/`codebuddy` 写入各自配置。`--dry-run` 只打印将要做的事，`--force` 允许重装已安装目标。
 - `sync` 把 CPA 模型列表和更新时间写到 `state_dir/models.json`（默认 `~/.cpac/models.json`）。这个时间戳就是模型版本：列表没变则时间戳不变，目标上次同步到的版本相同就跳过，不同才重写。不带参数只看已安装目标；`--all` 还会装上检测到但还没接入的目标。`install` 仍总是重写。`spawn_models`、`v2_off`、`max_context` 和代理端口不改这个版本，要马上生效用 `cpac install`。`--max_context` 仍只对 `cpac install codex` 有效。

package/dist/cpac.js

@@ -13,6 +13,7 @@ import { isZedConfigInstalled } from "./targets/zed.js";
 import { isHermesConfigInstalled } from "./targets/hermes.js";
 import { isCodebuddyConfigInstalled } from "./targets/codebuddy.js";
 import { defaultConfigPath, loadConfig, originalBytes, pickSpawnModels, readState, saveSpawnModels, stateProxy, catalogMaxContextLive, catalogModelId, catalogModelRows, catalogSlugs, fetchCatalog, } from "./config.js";
+import { canonicalModels, diffModelSlugs, readModelIndex } from "./models.js";
 import { runPing } from "./ping.js";
 import { proxyIsHealthy, runProxyChild } from "./proxy.js";
 import { CPACError, expandUserPath, promptSecret, saveApiKeyExport, shellProfile, } from "./util.js";
@@ -93,11 +94,30 @@ export async function status(config) {
         return 2;
     return 0;
 }
-async function listModels(config, json) {
+async function listModels(config, json, diff = false) {
     const apiKey = process.env[config.api_key_env]?.trim();
     if (!apiKey)
         throw new CPACError(`environment variable ${config.api_key_env} is not set`);
     const catalog = await fetchCatalog(config.cpa_url, apiKey);
+    if (diff) {
+        const index = readModelIndex(config.state_dir);
+        if (!index)
+            throw new CPACError("no saved model list; run cpac sync");
+        const { added, removed } = diffModelSlugs(index.models.map((model) => model.slug), canonicalModels(catalog.bytes).map((model) => model.slug));
+        if (json) {
+            console.log(JSON.stringify({ added, removed }, null, 2));
+            return 0;
+        }
+        if (added.length === 0 && removed.length === 0) {
+            console.log("unchanged");
+            return 0;
+        }
+        for (const slug of added)
+            console.log(`+ ${slug}`);
+        for (const slug of removed)
+            console.log(`- ${slug}`);
+        return 0;
+    }
     if (!json) {
         for (const slug of catalogSlugs(catalog.bytes))
             console.log(slug);
@@ -183,6 +203,7 @@ function usage() {
         "",
         "Command options:",
         opt("--json", "JSON output", "[models, detect]"),
+        opt("--diff", "models added or removed since the saved list", "[models]"),
         opt("--all", "every detected or installed agent", "[install, sync, restore]"),
         opt("--dry-run", "print actions without writing", "[install, sync, restore, uninstall]"),
         opt("--force", "allow reinstall of already-injected agents", "[install]"),
@@ -288,6 +309,11 @@ function parseArgs(args) {
             }
             if (arg === "--json")
                 parsed.json = true;
+            else if (arg === "--diff") {
+                if (parsed.command !== "models")
+                    throw new CPACError("--diff is only valid with models");
+                parsed.diff = true;
+            }
             else if (arg === "--all")
                 parsed.all = true;
             else if (arg === "--dry-run")
@@ -654,7 +680,7 @@ export async function main(args = process.argv.slice(2)) {
         if (parsed.command === "guide")
             return await guide(config);
         if (parsed.command === "models")
-            return await listModels(config, parsed.json);
+            return await listModels(config, parsed.json, parsed.diff === true);
         if (parsed.command === "detect")
             return await runDetect(config, parsed.json);
         if (parsed.command === "install") {

package/dist/models.js

@@ -33,6 +33,14 @@ function stableValue(value) {
         stable[key] = stableValue(value[key]);
     return stable;
 }
+export function diffModelSlugs(saved, live) {
+    const savedSet = new Set(saved);
+    const liveSet = new Set(live);
+    return {
+        added: live.filter((slug) => !savedSet.has(slug)),
+        removed: saved.filter((slug) => !liveSet.has(slug)),
+    };
+}
 export function canonicalModels(bytes) {
     let document;
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yhong91/cpac",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Connect Codex and Claude Code to a remote CLIProxyAPI gateway",
   "type": "module",
   "bin": {