@blxzer/cursor-trellis 0.4.2 → 0.4.3

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

@@ -1,94 +0,0 @@
-#!/usr/bin/env python3
-"""Cursor++ local bundle smoke check — whitelist metadata only, no secret reads."""
-from __future__ import annotations
-
-import json
-import os
-import sys
-from pathlib import Path
-
-from patch_wpelc8 import (
-    MARKER,
-    _load_config,
-    configured_slot_map,
-    probe_wpelc8_compat,
-    try_resolve_extension_js,
-)
-
-CAVEATS = [
-    "Cursor++ is third-party; reverse-engineering is version-bound",
-    "Never reads BYOK provider catalog file contents",
-    "Patch is operator-only; not part of CI or default Trellis workflow",
-    "Re-verify after any Cursor or Cursor++ upgrade",
-]
-
-
-def detect_env() -> tuple[str, str | None]:
-    env_flag = os.environ.get("TRELLIS_CURSOR_BYOK", "").strip()
-    if env_flag == "1":
-        return "byok", "TRELLIS_CURSOR_BYOK=1"
-    if env_flag == "0":
-        return "native", "TRELLIS_CURSOR_BYOK=0"
-
-    routes = Path.home() / ".ccursor" / "routes.json"
-    if routes.is_file():
-        try:
-            data = json.loads(routes.read_text(encoding="utf-8"))
-            byok = data.get("byokMode")
-            if byok in (1, "1", True):
-                return "byok", "routes.json:byokMode"
-            if byok in (0, "0", False):
-                return "native", "routes.json:byokMode"
-        except (OSError, json.JSONDecodeError, TypeError):
-            pass
-    return "unknown", None
-
-
-def detect_patch_status(bundle_dir: Path, config: dict) -> tuple[str, dict[str, object]]:
-    extension = try_resolve_extension_js(bundle_dir, config)
-    meta: dict[str, object] = {"extension": str(extension) if extension else None}
-    if extension is None:
-        return "not-applied", meta
-
-    source = extension.read_text(encoding="utf-8", errors="ignore")
-    marker_present = MARKER in source
-    meta["patch_marker_present"] = marker_present
-    probe = probe_wpelc8_compat(source)
-    meta.update(probe)
-
-    if not marker_present:
-        return "not-applied", meta
-
-    if probe["wpelc8"] == "not_locatable" or probe["inject_anchor"] == "missing":
-        return "stale", meta
-    if probe["wpelc8"] == "unknown" or probe["inject_anchor"] == "unknown":
-        return "stale", meta
-    return "applied", meta
-
-
-def main() -> int:
-    bundle_dir = Path(__file__).resolve().parent
-    config = _load_config(bundle_dir)
-    env, env_source = detect_env()
-    patch_status, patch_meta = detect_patch_status(bundle_dir, config)
-    slots = configured_slot_map(bundle_dir, config)
-
-    report = {
-        "env": env,
-        "env_source": env_source,
-        "patch_status": patch_status,
-        "patch_meta": patch_meta,
-        "current_map": {
-            "configured_roles": {
-                role: {"candidates": names} for role, names in sorted(slots.items())
-            },
-            "note": "Role names from user JSON5 config only; slugs not resolved (no provider catalog read)",
-        },
-        "caveats": CAVEATS,
-    }
-    print(json.dumps(report, indent=2, sort_keys=True))
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

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

@@ -1,4 +0,0 @@
-{
-  "_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.",
-  "cstl-implement": "qwen3.6-plus"
-}

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

@@ -1,10 +0,0 @@
-{
-  "_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.",
-  "cstl-research": "glm-5.1",
-  "cstl-implement": "qwen3.6-plus",
-  "cstl-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

@@ -1,45 +0,0 @@
-// 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 cstl-research）
-    "cstl-research": {
-      "primary": "glm-5.1",
-      "fallback": "qwen3.7-max"
-    },
-
-    // Trellis 实现；Parent generate-child-prompt --mode subagent 默认派发此类型
-    "cstl-implement": {
-      "primary": "qwen3.6-plus",
-      "fallback": "kimi-k2.7-code"
-    },
-
-    // Trellis 验收（Task cstl-check）
-    "cstl-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

@@ -1,200 +0,0 @@
-"""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 = (
-    "cstl-research",
-    "cstl-implement",
-    "cstl-check",
-    "generalPurpose",
-    "shell",
-    "best-of-n-runner",
-)
-
-SUBAGENT_TYPE_HELP: dict[str, str] = {
-    "cstl-research": "Trellis 调研 Task（cstl-research）",
-    "cstl-implement": "Trellis 实现 Task；Parent/Child 默认派发类型",
-    "cstl-check": "Trellis 验收 Task（cstl-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/utils/cursor-sdk-gate.d.ts

@@ -1,10 +0,0 @@
-/**
- * Cursor SDK capability gate (productization): env probe + user-facing guidance.
- * Never echoes the key value. Never writes secrets to the repo.
- */
-export declare function hasCursorApiKey(env?: NodeJS.ProcessEnv): boolean;
-/** Multi-line guide for missing CURSOR_API_KEY (init/update / sdk status). */
-export declare function cursorApiKeySetupGuide(): string;
-export declare function formatCursorSdkSkippedMessage(): string;
-export declare function formatCursorSdkEnabledMessage(): string;
-//# sourceMappingURL=cursor-sdk-gate.d.ts.map

package/dist/utils/cursor-sdk-gate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cursor-sdk-gate.d.ts","sourceRoot":"","sources":["../../src/utils/cursor-sdk-gate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,eAAe,CAC7B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAET;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,IAAI,MAAM,CAS/C;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAKtD;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAMtD"}

package/dist/utils/cursor-sdk-gate.js

@@ -1,32 +0,0 @@
-/**
- * Cursor SDK capability gate (productization): env probe + user-facing guidance.
- * Never echoes the key value. Never writes secrets to the repo.
- */
-export function hasCursorApiKey(env = process.env) {
-    return Boolean(env.CURSOR_API_KEY?.trim());
-}
-/** Multi-line guide for missing CURSOR_API_KEY (init/update / sdk status). */
-export function cursorApiKeySetupGuide() {
-    return [
-        "Cursor SDK live capability requires CURSOR_API_KEY in the current process environment.",
-        "Set it for your shell/session (user-level env or secret store) — never commit the key to the repo.",
-        "PowerShell example: $env:CURSOR_API_KEY = '<your-key>'",
-        "Then re-run init/update capability selection, or: cstl sdk status",
-        "Reminder: SDK live billing/privacy is a separate channel from Cursor IDE Native API vs Cursor++ BYOK model routing.",
-        "Until a key is set, cstl sdk run --mock still works; --live will refuse.",
-    ].join("\n");
-}
-export function formatCursorSdkSkippedMessage() {
-    return [
-        "Skipped enabling capability `cursor-sdk` (CURSOR_API_KEY not set).",
-        cursorApiKeySetupGuide(),
-    ].join("\n");
-}
-export function formatCursorSdkEnabledMessage() {
-    return [
-        "Enabled capability `cursor-sdk` (CURSOR_API_KEY is present in this process).",
-        "Use `cstl sdk status` to re-check, and `cstl sdk run --task <path> --live` only after you accept billing/privacy risk.",
-        "Native vs BYOK IDE routing does not replace CURSOR_API_KEY for SDK live runs.",
-    ].join("\n");
-}
-//# sourceMappingURL=cursor-sdk-gate.js.map

package/dist/utils/cursor-sdk-gate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cursor-sdk-gate.js","sourceRoot":"","sources":["../../src/utils/cursor-sdk-gate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,eAAe,CAC7B,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,wFAAwF;QACxF,oGAAoG;QACpG,wDAAwD;QACxD,mEAAmE;QACnE,qHAAqH;QACrH,0EAA0E;KAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO;QACL,oEAAoE;QACpE,sBAAsB,EAAE;KACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO;QACL,8EAA8E;QAC9E,wHAAwH;QACxH,+EAA+E;KAChF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}