@blxzer/cursor-trellis 0.1.0

package/dist/templates/trellis/local/index.js

@@ -0,0 +1,14 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function readLocal(name) {
+    return readFileSync(join(__dirname, name), "utf-8");
+}
+export const cursor2plusPatchScript = readLocal("patch_wpelc8.py");
+export const cursor2plusReadme = readLocal("README.md");
+export const cursor2plusConfigExample = readLocal("config.local.json.example");
+export const subagentModelsExample = readLocal("subagent-models.json.example");
+export const trellisTaskModelsJson5Example = readLocal("trellis-task-models.json5.example");
+export const trellisTaskModelsConfigPy = readLocal("trellis_task_models_config.py");
+//# sourceMappingURL=index.js.map

package/dist/templates/trellis/local/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/templates/trellis/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC,2BAA2B,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,SAAS,CAAC,8BAA8B,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,6BAA6B,GAAG,SAAS,CACpD,mCAAmC,CACpC,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,CAAC,+BAA+B,CAAC,CAAC"}

package/dist/templates/trellis/local/patch_wpelc8.py

@@ -0,0 +1,297 @@
+"""Trellis: reversible Cursor++ WPeLc8 subagent model map (BYOK). See README.md."""
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+
+from trellis_task_models_config import (
+    KNOWN_SUBAGENT_TYPES,
+    SUBAGENT_TYPE_HELP,
+    extract_raw_slots,
+    load_providers_catalog,
+    load_task_models_document,
+    resolve_slots_to_slugs,
+)
+
+MARKER = "/*TRELLIS_B2_WPeLc8*/"
+
+
+def _repo_root(start: Path) -> Path:
+    cur = start.resolve()
+    for _ in range(12):
+        if (cur / ".trellis").is_dir():
+            return cur
+        if cur.parent == cur:
+            break
+        cur = cur.parent
+    return start.resolve()
+
+
+def _merge_slot_maps(*layers: dict[str, list[str]]) -> dict[str, list[str]]:
+    merged: dict[str, list[str]] = {}
+    for layer in layers:
+        for k, v in layer.items():
+            merged[k] = list(v)
+    return merged
+
+
+def _ccursor_home(config: dict) -> Path:
+    for key in ("ccursorHome", "ccursor_home"):
+        if isinstance(config.get(key), str) and config[key].strip():
+            return Path(config[key].strip()).expanduser()
+    env = os.environ.get("TRELLIS_CCURSOR_HOME", "").strip()
+    if env:
+        return Path(env).expanduser()
+    return Path.home() / ".ccursor"
+
+
+def _load_config(bundle_dir: Path) -> dict:
+    cfg_path = bundle_dir / "config.local.json"
+    if not cfg_path.is_file():
+        return {}
+    try:
+        data = json.loads(cfg_path.read_text(encoding="utf-8"))
+        return data if isinstance(data, dict) else {}
+    except (OSError, json.JSONDecodeError):
+        return {}
+
+
+def resolve_providers_json(config: dict) -> Path:
+    for key in ("providersJson", "providers_json"):
+        if isinstance(config.get(key), str) and config[key].strip():
+            return Path(config[key].strip()).expanduser()
+    env = os.environ.get("TRELLIS_CCURSOR_PROVIDERS", "").strip()
+    if env:
+        return Path(env).expanduser()
+    return _ccursor_home(config) / "providers.json"
+
+
+def _first_existing(*paths: Path) -> Path | None:
+    for p in paths:
+        if p.is_file():
+            return p
+    return None
+
+
+def resolve_user_models_path(config: dict) -> Path:
+    ccursor = _ccursor_home(config)
+    if isinstance(config.get("userModelsJson"), str) and config["userModelsJson"].strip():
+        return Path(config["userModelsJson"].strip()).expanduser()
+    found = _first_existing(
+        ccursor / "trellis-task-models.json5",
+        ccursor / "trellis-task-models.json",
+    )
+    return found or (ccursor / "trellis-task-models.json5")
+
+
+def resolve_project_models_path(bundle_dir: Path, config: dict) -> Path | None:
+    root = _repo_root(bundle_dir)
+    if isinstance(config.get("projectModelsJson"), str) and config["projectModelsJson"].strip():
+        p = Path(config["projectModelsJson"].strip()).expanduser()
+        return p if p.is_file() else None
+    return _first_existing(
+        root / ".trellis" / "local" / "subagent-models.json5",
+        root / ".trellis" / "local" / "subagent-models.json",
+    )
+
+
+def resolve_model_layers(bundle_dir: Path, config: dict, providers_path: Path) -> tuple[dict[str, str], list[str]]:
+    user_path = resolve_user_models_path(config)
+    project_path = resolve_project_models_path(bundle_dir, config)
+    user_slots = extract_raw_slots(load_task_models_document(user_path))
+    project_slots = (
+        extract_raw_slots(load_task_models_document(project_path))
+        if project_path
+        else {}
+    )
+    merged = _merge_slot_maps(user_slots, project_slots)
+    return resolve_slots_to_slugs(merged, providers_path)
+
+
+def resolve_extension_js(bundle_dir: Path, config: dict) -> Path:
+    for key in ("extensionJs", "extension_js"):
+        if isinstance(config.get(key), str) and config[key].strip():
+            return Path(config[key].strip()).expanduser()
+    env = os.environ.get("TRELLIS_CURSOR2PLUS_EXTENSION", "").strip()
+    if env:
+        return Path(env).expanduser()
+    if sys.platform == "win32":
+        local = os.environ.get("LOCALAPPDATA", "")
+        candidates = [
+            Path(local) / "Programs" / "cursor" / "resources" / "app" / "extensions" / "cursor2plus" / "dist" / "extension.js",
+            Path(r"D:\cursor\resources\app\extensions\cursor2plus\dist\extension.js"),
+        ]
+    elif sys.platform == "darwin":
+        candidates = [
+            Path("/Applications/Cursor.app/Contents/Resources/app/extensions/cursor2plus/dist/extension.js"),
+        ]
+    else:
+        candidates = [
+            Path.home() / ".local" / "share" / "cursor" / "resources" / "app" / "extensions" / "cursor2plus" / "dist" / "extension.js",
+        ]
+    for c in candidates:
+        if c.is_file():
+            return c
+    raise SystemExit(
+        "extension.js not found. Set extensionJs in config.local.json or run --bootstrap"
+    )
+
+
+def build_inject_block(model_map: dict[str, str]) -> str:
+    if not model_map:
+        raise SystemExit(
+            "model map empty — use skill trellis-cursor2plus-setup or write "
+            "~/.ccursor/trellis-task-models.json5 (see .trellis/local/trellis-task-models.json5.example)"
+        )
+    pairs = ",".join(f'"{k}":"{v}"' for k, v in sorted(model_map.items()))
+    return (
+        f"{MARKER}{{const __T={{{pairs}}};const __m=__T[fQ4YPip];"
+        "if(__m&&(!UbAQWn||UbAQWn[Vyazt1(gvQ2P56[0x24a3])][Vyazt1(gvQ2P56[0x204e])]"
+        "===Vyazt1(gvQ2P56[0x2cda])))return __m;}"
+    )
+
+
+def find_wpelc8_body(source: str) -> tuple[int, int]:
+    start = source.find("function WPeLc8(")
+    if start < 0:
+        raise SystemExit("WPeLc8 not found — Cursor++/extension version mismatch?")
+    end = source.find("async function*o4ZNpa", start)
+    if end < 0:
+        raise SystemExit("WPeLc8 end anchor not found")
+    return start, end
+
+
+def apply_patch(source: str, inject: str) -> str:
+    start, end = find_wpelc8_body(source)
+    fn = source[start:end]
+    if MARKER in fn:
+        fn = remove_patch_from_fn(fn)
+    needle = "});return!UbAQWn||"
+    if needle not in fn:
+        raise SystemExit(f"inject anchor missing: {needle!r}")
+    fn_new = fn.replace(needle, f"}});{inject}return!UbAQWn||", 1)
+    return source[:start] + fn_new + source[end:]
+
+
+def remove_patch_from_fn(fn: str) -> str:
+    import re
+
+    return re.sub(
+        re.escape(MARKER) + r"\{const __T=\{[^}]+\};const __m=__T\[fQ4YPip\];"
+        r"if\(__m&&\(!UbAQWn\|\|UbAQWn\[Vyazt1\(gvQ2P56\[0x24a3\]\)\]\[Vyazt1\(gvQ2P56\[0x204e\]\)\]"
+        r"===Vyazt1\(gvQ2P56\[0x2cda\]\)\)\)return __m;\}",
+        "",
+        fn,
+        count=1,
+    )
+
+
+def remove_patch(source: str) -> str:
+    if MARKER not in source:
+        raise SystemExit("marker not found — not patched?")
+    start, end = find_wpelc8_body(source)
+    fn = remove_patch_from_fn(source[start:end])
+    return source[:start] + fn + source[end:]
+
+
+def cmd_explain() -> None:
+    print("trellis-task-models.json5 — Agent 协助填写；用户只选模型名")
+    print("每项: { primary, fallback } — 首选不可用则自动备选 (WARN)")
+    print()
+    for key in KNOWN_SUBAGENT_TYPES:
+        print(f"  {key}")
+        print(f"    → {SUBAGENT_TYPE_HELP.get(key, '')}")
+    print()
+    print("Skill: trellis-cursor2plus-setup (init 后与大模型交互完成配置)")
+
+
+def cmd_list_models(providers_path: Path) -> None:
+    by_slug, _ = load_providers_catalog(providers_path)
+    if not by_slug:
+        raise SystemExit(f"no models in {providers_path}")
+    print(f"# {providers_path}")
+    print("# 给用户选 primary/fallback 时引用 apiModel 或 displayName")
+    print()
+    rows = sorted(by_slug.values(), key=lambda r: (str(r.get("provider")), str(r.get("displayName"))))
+    for r in rows:
+        print(
+            f"  {r.get('displayName')!r:28} apiModel={r.get('apiModel')!r:32} "
+            f"slug={r.get('slug')}  provider={r.get('provider')}"
+        )
+
+
+def cmd_bootstrap(bundle_dir: Path) -> None:
+    config = _load_config(bundle_dir)
+    cfg_out = bundle_dir / "config.local.json"
+    if not cfg_out.is_file():
+        config = {}
+    try:
+        resolve_extension_js(bundle_dir, config)
+        print("extension.js auto-detected", file=sys.stderr)
+    except SystemExit:
+        path = input("Paste full path to cursor2plus/dist/extension.js: ").strip()
+        if path:
+            config["extensionJs"] = path
+    cfg_out.write_text(json.dumps(config, indent=2) + "\n", encoding="utf-8")
+    print("wrote", cfg_out)
+    print("Next: in Cursor Agent, run skill trellis-cursor2plus-setup", file=sys.stderr)
+
+
+def main() -> None:
+    ap = argparse.ArgumentParser(description="Trellis Cursor++ WPeLc8 model map")
+    ap.add_argument("--revert", action="store_true")
+    ap.add_argument("--dry-run", action="store_true")
+    ap.add_argument("--bootstrap", action="store_true")
+    ap.add_argument("--explain", action="store_true")
+    ap.add_argument("--list-models", action="store_true")
+    ap.add_argument("--print-map", action="store_true")
+    args = ap.parse_args()
+
+    bundle_dir = Path(__file__).resolve().parent
+    if args.explain:
+        cmd_explain()
+        return
+    if args.bootstrap:
+        cmd_bootstrap(bundle_dir)
+        return
+
+    config = _load_config(bundle_dir)
+    providers_path = resolve_providers_json(config)
+
+    if args.list_models:
+        cmd_list_models(providers_path)
+        return
+
+    model_map, notes = resolve_model_layers(bundle_dir, config, providers_path)
+    if notes:
+        print("resolve:", file=sys.stderr)
+        for line in notes:
+            print(line, file=sys.stderr)
+    if any("ERROR" in line for line in notes):
+        raise SystemExit(1)
+
+    if args.print_map:
+        print(json.dumps(model_map, indent=2, sort_keys=True))
+        return
+
+    extension = resolve_extension_js(bundle_dir, config)
+    source = extension.read_text(encoding="utf-8", errors="ignore")
+    if args.revert:
+        new = remove_patch(source)
+    else:
+        inject = build_inject_block(model_map)
+        new = apply_patch(source, inject)
+
+    if args.dry_run:
+        print("ok", "revert" if args.revert else "patch", "delta", len(new) - len(source))
+        return
+
+    extension.write_text(new, encoding="utf-8", newline="\n")
+    print("wrote", extension)
+
+
+if __name__ == "__main__":
+    main()

package/dist/templates/trellis/local/subagent-models.json.example

@@ -0,0 +1,4 @@
+{
+  "_comment": "Optional repo overrides (~/.ccursor/trellis-task-models.json is user-wide). Same value rules: apiModel, displayName, or model-xxxxx slug. Project wins on same key.",
+  "trellis-implement": "qwen3.6-plus"
+}

package/dist/templates/trellis/local/trellis-task-models.json.example

@@ -0,0 +1,10 @@
+{
+  "_comment": "Copy to ~/.ccursor/trellis-task-models.json (Windows: %USERPROFILE%\\.ccursor\\). Values: use apiModel or displayName from Cursor++ — patch_wpelc8.py resolves to slug at patch time. Optional keys: omit types you do not use.",
+  "_when_providers_change": "Run: python patch_wpelc8.py --list-models then fix this file and patch again.",
+  "trellis-research": "glm-5.1",
+  "trellis-implement": "qwen3.6-plus",
+  "trellis-check": "qwen3.7-max",
+  "generalPurpose": "gpt-5.5",
+  "shell": "grok-composer-2.5-fast",
+  "best-of-n-runner": "kimi-k2.7-code"
+}

package/dist/templates/trellis/local/trellis-task-models.json5.example

@@ -0,0 +1,45 @@
+// Trellis + Cursor++ BYOK — Task 子代理模型路由（由 Agent 在 init 时协助填写）
+// 复制到: Windows %USERPROFILE%\.ccursor\trellis-task-models.json5
+//         Linux/macOS ~/.ccursor/trellis-task-models.json5
+//
+// 用户：只说明「每个场景想用哪个模型」（Cursor++ 里显示的名字即可）
+// Agent：运行 list-models → 写入本文件（保留注释）→ patch_wpelc8.py
+//
+// primary / fallback：providers.json 变更时，首选解析失败会自动用备选（WARN，不中断）
+// Explore 子代理不在此文件 — 用 Cursor++ 面板单独选
+
+{
+  "models": {
+    // Trellis 调研（Task trellis-research）
+    "trellis-research": {
+      "primary": "glm-5.1",
+      "fallback": "qwen3.7-max"
+    },
+
+    // Trellis 实现；Parent generate-child-prompt --mode subagent 默认派发此类型
+    "trellis-implement": {
+      "primary": "qwen3.6-plus",
+      "fallback": "kimi-k2.7-code"
+    },
+
+    // Trellis 验收（Task trellis-check）
+    "trellis-check": {
+      "primary": "qwen3.7-max",
+      "fallback": "glm-5.1"
+    },
+
+    // Cursor 内置 Task（可按需删掉不用的项）
+    "generalPurpose": {
+      "primary": "gpt-5.5",
+      "fallback": "glm-5.1"
+    },
+    "shell": {
+      "primary": "grok-composer-2.5-fast",
+      "fallback": "gpt-5.5"
+    },
+    "best-of-n-runner": {
+      "primary": "kimi-k2.7-code",
+      "fallback": "qwen3.6-plus"
+    }
+  }
+}

package/dist/templates/trellis/local/trellis_task_models_config.py

@@ -0,0 +1,200 @@
+"""Load trellis-task-models (JSON5) and resolve primary/fallback against providers.json."""
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any
+
+KNOWN_SUBAGENT_TYPES = (
+    "trellis-research",
+    "trellis-implement",
+    "trellis-check",
+    "generalPurpose",
+    "shell",
+    "best-of-n-runner",
+)
+
+SUBAGENT_TYPE_HELP: dict[str, str] = {
+    "trellis-research": "Trellis 调研 Task（trellis-research）",
+    "trellis-implement": "Trellis 实现 Task；Parent/Child 默认派发类型",
+    "trellis-check": "Trellis 验收 Task（trellis-check）",
+    "generalPurpose": "Cursor 内置 Task：generalPurpose",
+    "shell": "Cursor 内置 Task：shell",
+    "best-of-n-runner": "Cursor 内置 Task：best-of-n-runner",
+}
+
+
+def strip_json5_comments(text: str) -> str:
+    out: list[str] = []
+    i = 0
+    n = len(text)
+    in_string = False
+    escape = False
+    while i < n:
+        c = text[i]
+        if in_string:
+            out.append(c)
+            if escape:
+                escape = False
+            elif c == "\\":
+                escape = True
+            elif c == '"':
+                in_string = False
+            i += 1
+            continue
+        if c == '"':
+            in_string = True
+            out.append(c)
+            i += 1
+            continue
+        if c == "/" and i + 1 < n:
+            nxt = text[i + 1]
+            if nxt == "/":
+                while i < n and text[i] != "\n":
+                    i += 1
+                continue
+            if nxt == "*":
+                i += 2
+                while i + 1 < n and not (text[i] == "*" and text[i + 1] == "/"):
+                    i += 1
+                i = min(i + 2, n)
+                continue
+        out.append(c)
+        i += 1
+    return "".join(out)
+
+
+def load_providers_catalog(
+    providers_path: Path,
+) -> tuple[dict[str, dict], dict[str, str]]:
+    by_slug: dict[str, dict] = {}
+    alias_to_slug: dict[str, str] = {}
+    if not providers_path.is_file():
+        return by_slug, alias_to_slug
+    try:
+        root = json.loads(providers_path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return by_slug, alias_to_slug
+    for prov in root.get("providers") or []:
+        if not isinstance(prov, dict):
+            continue
+        pname = prov.get("name") or prov.get("id") or "?"
+        for m in prov.get("models") or []:
+            if not isinstance(m, dict):
+                continue
+            slug = m.get("id")
+            if not isinstance(slug, str) or not slug.strip():
+                continue
+            slug = slug.strip()
+            row = {
+                "slug": slug,
+                "apiModel": m.get("apiModel") or "",
+                "displayName": m.get("displayName") or "",
+                "provider": pname,
+            }
+            by_slug[slug] = row
+            for field in ("id", "apiModel", "displayName"):
+                val = m.get(field)
+                if isinstance(val, str) and val.strip():
+                    key = val.strip().lower()
+                    if key not in alias_to_slug:
+                        alias_to_slug[key] = slug
+    return by_slug, alias_to_slug
+
+
+def resolve_one_alias(
+    raw: str,
+    by_slug: dict[str, dict],
+    alias_to_slug: dict[str, str],
+) -> str | None:
+    if raw in by_slug:
+        return raw
+    key = raw.strip().lower()
+    if key in alias_to_slug:
+        return alias_to_slug[key]
+    return None
+
+
+def _coerce_slot(value: Any) -> list[str]:
+    if value is None:
+        return []
+    if isinstance(value, str) and value.strip():
+        return [value.strip()]
+    if isinstance(value, list):
+        out: list[str] = []
+        for item in value:
+            if isinstance(item, str) and item.strip():
+                out.append(item.strip())
+        return out
+    return []
+
+
+def load_task_models_document(path: Path) -> dict[str, Any]:
+    if not path.is_file():
+        return {}
+    text = path.read_text(encoding="utf-8")
+    try:
+        data = json.loads(strip_json5_comments(text))
+    except json.JSONDecodeError:
+        return {}
+    return data if isinstance(data, dict) else {}
+
+
+def extract_raw_slots(doc: dict[str, Any]) -> dict[str, list[str]]:
+    """subagent_type -> ordered candidates [primary, fallback, ...]."""
+    slots: dict[str, list[str]] = {}
+    for key, value in doc.items():
+        if not isinstance(key, str) or key.startswith("_"):
+            continue
+        if key == "models" and isinstance(value, dict):
+            for st, spec in value.items():
+                if not isinstance(st, str) or st.startswith("_"):
+                    continue
+                if isinstance(spec, dict):
+                    candidates = _coerce_slot(spec.get("primary"))
+                    candidates.extend(_coerce_slot(spec.get("fallback")))
+                    candidates.extend(_coerce_slot(spec.get("fallbacks")))
+                else:
+                    candidates = _coerce_slot(spec)
+                if candidates:
+                    slots[st] = candidates
+            continue
+        candidates = _coerce_slot(value)
+        if candidates:
+            slots[key] = candidates
+    return slots
+
+
+def resolve_slots_to_slugs(
+    slots: dict[str, list[str]],
+    providers_path: Path,
+) -> tuple[dict[str, str], list[str]]:
+    by_slug, alias_to_slug = load_providers_catalog(providers_path)
+    resolved: dict[str, str] = {}
+    notes: list[str] = []
+    for subagent_type, candidates in sorted(slots.items()):
+        chosen_slug: str | None = None
+        used_label: str | None = None
+        for idx, cand in enumerate(candidates):
+            slug = resolve_one_alias(cand, by_slug, alias_to_slug)
+            if slug:
+                chosen_slug = slug
+                used_label = cand
+                if idx > 0:
+                    notes.append(
+                        f"  WARN {subagent_type}: primary unavailable; using fallback "
+                        f"{cand!r} → {slug}"
+                    )
+                elif len(candidates) > 1:
+                    row = by_slug.get(slug, {})
+                    label = row.get("displayName") or row.get("apiModel") or cand
+                    notes.append(f"  OK {subagent_type}: {cand!r} → {slug} ({label})")
+                break
+        if chosen_slug:
+            resolved[subagent_type] = chosen_slug
+        else:
+            tried = ", ".join(repr(c) for c in candidates)
+            notes.append(
+                f"  ERROR {subagent_type}: no match for [{tried}] in providers.json"
+            )
+    return resolved, notes

package/dist/templates/trellis/scripts/__init__.py

@@ -0,0 +1,5 @@
+"""
+Trellis Python Scripts
+
+This module provides Python implementations of Trellis workflow scripts.
+"""